Introducción a las herramientas MCP de Linkly AI

Documentation Index

Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

Visión general de herramientas

search → grep or outline → read

​

Búsqueda (search)

​

Parámetros

• Cuando el usuario indique una ventana temporal explícita (“el mes pasado”, “en 2024”, “los últimos tres meses”), use modified_after / modified_before.
• Cuando el usuario solo dice “reciente”, “más reciente”, “más antiguo” sin un rango fijo, use time_sort=newest u oldest.
• Ambos pueden combinarse: “el más antiguo en 2024” es modified_after=2024-01-01 + modified_before=2024-12-31 + time_sort=oldest.
• Para fechas relativas (“el mes pasado”), lea primero la hora UTC actual desde el campo [meta] now=... al final de cualquier respuesta de herramienta, luego calcule la fecha — vea Metadatos de respuesta más abajo.

​

Campos de respuesta

​

Ejemplos de uso

# Vía CLI
linkly search "project management best practices" --limit 10

# Filtrar por tipo de documento
linkly search "quarterly report" --type pdf,docx --json

# Buscar dentro de una biblioteca específica
linkly search "deep learning" --library my-research --limit 10

# Filtrar por ruta de archivo
linkly search "report" --path-glob "*2024*"

# Limitar por ventana temporal (informes trimestrales del Q3 2024)
linkly search "quarterly report" --modified-after 2024-07-01 --modified-before 2024-09-30

# Ordenar por fecha ("el más reciente", "el más antiguo" — sin rango fijo)
linkly search "weekly retro" --time-sort newest --limit 5

​

Esquema (outline)

​

Parámetros

​

Cuándo usar el esquema

​

Ejemplos de uso

# Ver esquema de un solo documento
linkly outline abc123

# Ver múltiples documentos a la vez
linkly outline id1 id2 id3

# Salida en formato JSON
linkly outline abc123 --json

​

Grep

​

Parámetros

​

Cuándo usar Grep vs Esquema

​

Ejemplos de uso

# Encontrar términos específicos en un documento
linkly grep "quarterly revenue" 456

# Búsqueda sin distinción de mayúsculas con contexto
linkly grep "error|warning" 1044 -C 3 -i

# Previsualizar recuento de coincidencias antes de leer
linkly grep "TODO" 591 --mode count

​

Lectura (read)

​

Parámetros

​

Formato de contenido

  1	# Project Requirements Document
  2
  3	## 1. Project Background
  4
  5	This project aims to build an efficient knowledge management system...
  6	Target users are enterprise R&D teams and individual knowledge workers.

​

Estrategia de paginación

# Primera página: líneas 1-200
linkly read <DOC_ID> --offset 1 --limit 200

# Segunda página: líneas 201-400
linkly read <DOC_ID> --offset 201 --limit 200

# Tercera página: líneas 401-600
linkly read <DOC_ID> --offset 401 --limit 200

​

Ejemplos de uso

# Leer el inicio del documento
linkly read abc123

# Leer un rango específico
linkly read abc123 --offset 120 --limit 80

# Formato JSON (adecuado para procesamiento programático)
linkly read abc123 --json

​

Listar bibliotecas (list_libraries)

​

Parámetros

​

Casos de uso

• Cuando el usuario pregunta “¿qué bibliotecas tengo?”
• Antes de utilizar el parámetro library en search, para verificar el nombre de una biblioteca

linkly list-libraries

​

Explorar (explore)

​

Parámetros

​

Casos de uso

• El usuario desea saber qué contiene su base de conocimiento o colección de documentos
• El usuario no tiene un tema de búsqueda específico y desea descubrir temas y direcciones disponibles
• El asistente de IA necesita comprender la escala y la distribución temática para formular estrategias de búsqueda efectivas

# Explorar todos los documentos
linkly explore

# Explorar una biblioteca específica
linkly explore --library my-research

​

Localización de rutas (find_paths)

​

Parámetros

​

Campos de respuesta (modo JSON)

​

Comportamiento de agregación

• Los archivos cuyos patrones solo coinciden con el segmento de nombre de archivo (sin coincidencia en algún segmento de directorio) se descartan silenciosamente — esta es una herramienta para “encontrar carpetas”, no para “encontrar archivos”. Si una consulta no devuelve carpetas candidatas a pesar de que existan archivos coincidentes, recurra a llamar search directamente.
• Cada coincidencia se agrupa por la posición menos profunda de cualquier patrón en la ruta, truncada en el siguiente /. Así local:///Users/me/Documents/Notion-Export-abc/workspace/page.md coincidente con Notion se agrega bajo .../Documents/Notion-Export-abc, sin importar cuán profundo viva el archivo.

​

Cuándo usarla

• El usuario nombra un contenedor con una palabra ambigua o multilingüe (“en mis notas de Notion”, “en mi carpeta de papers de Dropbox”, “en mi respaldo de trabajo”) y no conoce la ruta real
• Antes de search, para determinar el valor de path_glob

​

Cuándo no usarla

• Consultas puramente de contenido / tema (“encuentra mis CV”, “encuentra papers de IA”) — llame search directamente; su búsqueda híbrida ya cubre título, nombre de archivo, contenido y ruta
• Filtrado solo por tipo de archivo (“todos los PDF”) — llame search con path_glob="*.pdf" directamente
• Consultas vagas sin intención de contenedor (“encuentra cosas recientes”) — llame search

​

Ejemplo de uso

# Usuario: "encuentra mis recibos de compra en mis notas de Notion"
# Paso 1: localizar la ruta real
linkly find-paths --patterns Notion,notion --limit 5
# Supongamos que devuelve .../Documents/Notion-Export-abc/workspace (1240 archivos)

# Paso 2: buscar dentro de ese contenedor
linkly search "shopping receipt" --path-glob "*Notion-Export*"

​

Metadatos de respuesta

• Salida Markdown: un bloque de pie de página al final de la respuesta, formateado como:
  ---
  [meta] now=2026-05-08T14:43:14Z
  
• Salida JSON: un objeto _meta de nivel superior:
  { ..., "_meta": { "now": "2026-05-08T14:43:14Z" } }
  

​

Ejemplos de flujo de trabajo

​

Flujo de trabajo completo: vía CLI

# Paso 1: Buscar documentos relevantes
linkly search "microservice architecture design" --limit 5

# Paso 2: Ver el esquema del documento objetivo (supongamos que doc_id es abc123)
linkly outline abc123

# Paso 3: Leer la sección de interés (supongamos que está entre las líneas 80-150)
linkly read abc123 --offset 80 --limit 70

​

Flujo de trabajo completo: vía MCP

// Paso 1: Búsqueda
{
  "method": "tools/call",
  "params": {
    "name": "search",
    "arguments": {
      "query": "microservice architecture design",
      "limit": 5
    }
  }
}

// Paso 2: Ver esquema
{
  "method": "tools/call",
  "params": {
    "name": "outline",
    "arguments": {
      "doc_ids": ["abc123"]
    }
  }
}

// Paso 3: Leer contenido
{
  "method": "tools/call",
  "params": {
    "name": "read",
    "arguments": {
      "doc_id": "abc123",
      "offset": 80,
      "limit": 70
    }
  }
}

​

Preguntas frecuentes