Integración con asistentes de IA (MCP)

Conecta Linkflare con tu asistente de IA preferido y gestiona tus marcadores mediante una conversación natural. Guarda enlaces, busca en tu biblioteca, organiza colecciones, todo sin salir de tu chat.

¿Qué es MCP?

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA interactuar con herramientas y datos externos. Imagínalo como dotar a tu IA de una serie de superpoderes; en este caso, la capacidad de leer, escribir y organizar tus marcadores de Linkflare.

Linkflare ofrece un servidor MCP alojado en https://mcp.linkflare.io/mcp, que funciona con cualquier cliente compatible con MCP, incluidos Claude Desktop, ChatGPT, Cursor, Windsurf y más.

¿Qué puedes hacer con él?

Una vez establecida la conexión, puedes hablar con tu asistente de IA en lenguaje sencillo, y él interactúa con tu biblioteca de Linkflare en tu nombre. Aquí tienes algunas cosas que puedes decir:

Guardar marcadores

«Guarda este enlace en mi colección Recetas: https://example.com/pasta-recipe"
«Añade https://arxiv.org/abs/2401.12345 y ponle las etiquetas machine-learning y research"
«Aquí tienes un montón de enlaces de mis notas, guárdalos todos:" (pega un bloque de texto con URL)

Buscar y encontrar

«Encuentra todos mis marcadores sobre TypeScript"
«Muéstrame vídeos con la etiqueta scotland"
«¿Qué recetas he guardado últimamente?"
«Encuentra artículos que he valorado con el pulgar hacia arriba"
«Busca repetición espaciada en mis tarjetas de conocimiento"

Organizar

«Mueve los enlaces 42 y 43 a mi colección Trabajo"
«Crea una nueva colección llamada Viaje a Japón"
«Crea una etiqueta llamada must-read"
«¿Qué hay en mi bandeja de entrada? Ayúdame a organizarla."

Capturar conocimiento Pro

Las tarjetas de conocimiento son notas jerárquicas con contenido enriquecido, etiquetas y repetición espaciada opcional. Las herramientas de conocimiento requieren un plan Pro.

«Crea una tarjeta de conocimiento con el título React Server Components y estas notas: …"
«Añade bajo Fundamentos de cocina una tarjeta secundaria para Habilidades con el cuchillo"
«Actualiza la tarjeta 42, añade: también funciona con async iterators"
«Muéstrame todas las tarjetas de conocimiento del nivel superior"
«¿Qué sé sobre bases de datos vectoriales? Resume mis tarjetas."

Revisar y reflexionar

«Dame un resumen de lo que he guardado esta semana"
«Resume lo que hay en mi colección Inspiración de diseño"
«Encuentra marcadores sobre diseño de interfaces de usuario"
«¿Qué marcadores todavía no tienen etiquetas? Sugiere algunas."
«Explora mi base de conocimiento sobre aprendizaje automático: ¿qué lagunas tengo?"

Ejemplos prácticos

🔬 Flujo de investigación

Estás investigando un tema y encuentras muchos artículos útiles. En lugar de cambiar a Linkflare, simplemente dile a tu IA:

«Guarda https://example.com/article en mi colección Investigación, ponle las etiquetas AI y transformers y valóralo con el pulgar hacia arriba"

📋 Ordenar la bandeja de entrada

Tu bandeja de entrada ha crecido. Pídele ayuda a tu IA:

«Muéstrame mi bandeja de entrada. Agrupa las entradas por tipo y sugiere a qué colección pertenece cada una."

🎬 Noche de cine

¿Planeas una noche de cine? Pide una recomendación de tu propia colección:

«Busca en mis marcadores películas que aún no haya valorado. Elige una que parezca una película de acción entretenida."

🍳 Planificación semanal de comidas

Has guardado recetas toda la semana. Hora de planificar:

«Muéstrame todas las recetas de mi bandeja de entrada. Elige 5 para las cenas de esta semana y muévelas a mi colección Plan de comidas."

📚 Repasar la lista de lectura

Ponte al día con lo que has guardado:

«Dame un resumen semanal de mis marcadores recientes. ¿Sobre qué temas he guardado más?"

✈️ Planificación de viajes

Llevas meses recopilando enlaces de viaje:

«Encuentra todos los marcadores con la etiqueta japan. Resume lo que he recopilado: restaurantes, hoteles, actividades."

💡 Guardar varios enlaces desde tus notas

Tienes un documento lleno de enlaces. Pégalo y di:

«Extrae todas las URL de este texto y guárdalas en mi colección Lista de lectura."

🧠 Captura lo que acabas de aprender Pro

Acabas de terminar de leer un artículo y quieres capturar las ideas clave como tarjeta de conocimiento:

«Crea una tarjeta de conocimiento con el título Rate Limiting Patterns bajo mi tarjeta superior Engineering. Notas: token bucket, leaky bucket, sliding window. Ponle las etiquetas backend y distributed-systems."

🔎 Comprobar lagunas de conocimiento Pro

Usa el prompt explore_knowledge para comprobar un tema antes de profundizar:

«Explora lo que sé sobre transformers. Resume mis tarjetas y luego enumera 3 subtemas que aún no haya capturado."

Requisitos previos

Una cuenta de Linkflare: regístrate aquí si aún no tienes una.
Tu clave de API: abre la app de Linkflare, haz clic en tu menú de usuario (arriba a la derecha) y elige Copiar clave de API.
Un cliente de IA que admita servidores MCP remotos (ver las guías de configuración más abajo).

Configuración: Claude

Claude admite conectores MCP remotos personalizados en Claude, Claude Desktop y planes de equipo compatibles. Añade Linkflare como conector web personalizado.

Paso 1: Abrir Connectors

Ve a Settings → Connectors y haz clic en Add custom connector.

Paso 2: Rellenar los datos del connector

Name: linkflare
Remote MCP server URL: https://mcp.linkflare.io/mcp

Paso 3: Configurar OAuth (Advanced settings)

Abre Advanced settings y define:

OAuth Client ID: linkflare-claude

Paso 4: Autorizar

Cuando uses las herramientas de Linkflare por primera vez en una conversación, Claude abre una página de autorización en la que pegas tu clave de API de Linkflare. Encuentras tu clave de API haciendo clic en tu menú de usuario (arriba a la derecha) en la app de Linkflare y eligiendo Copiar clave de API. Tras la autorización, Claude recuerda tu conexión.

Paso 5: Pruébalo

Inicia una conversación y di algo como:

«¿Qué hay en mi bandeja de entrada de Linkflare?"
«Busca en mis marcadores artículos sobre productividad"
«Guarda https://example.com en mi lista de lectura"

Claude pide permiso antes de usar una herramienta por primera vez.

Configuración: ChatGPT

ChatGPT admite servidores MCP remotos mediante las apps de ChatGPT y el Developer Mode. Linkflare admite la autenticación OAuth, de modo que ChatGPT puede conectarse de forma segura.

Paso 1: Abrir los ajustes de ChatGPT

Ve a Settings → Apps, luego desplázate hasta Advanced settings y haz clic en Create app.

Paso 2: Crear una nueva app

Rellena lo siguiente:

Name: Linkflare
MCP Server URL: https://mcp.linkflare.io/mcp
Authentication: OAuth

Si ChatGPT solicita datos adicionales de OAuth:

Client ID: linkflare-chatgpt
Client Secret: déjalo vacío

ChatGPT detecta automáticamente los endpoints de autorización y de token del servidor MCP.

Paso 3: Autorizar

Cuando uses las herramientas de Linkflare por primera vez en una conversación, ChatGPT abre una página de autorización en la que pegas tu clave de API de Linkflare. Encuentras tu clave de API haciendo clic en tu menú de usuario (arriba a la derecha) en la app de Linkflare y eligiendo Copiar clave de API. Tras la autorización, ChatGPT recuerda tu conexión.

Paso 4: Probar

Inicia una nueva conversación y pide a ChatGPT que «liste mis colecciones de Linkflare" para comprobar si la conexión funciona.

Configuración: VS Code

Usa el archivo de configuración MCP en VS Code. OAuth abre tu navegador en la primera conexión.

{
  "servers": {
    "linkflare": {
      "type": "http",
      "url": "https://mcp.linkflare.io/mcp",
      "oauth": {
        "clientId": "linkflare-vscode"
      }
    }
  }
}

Configuración: Cursor

Añade Linkflare a ~/.cursor/mcp.json o .cursor/mcp.json. Cursor usa un callback OAuth fijo y datos estáticos de cliente OAuth.

{
  "mcpServers": {
    "linkflare": {
      "url": "https://mcp.linkflare.io/mcp",
      "auth": {
        "CLIENT_ID": "linkflare-cursor",
        "scopes": ["mcp"]
      }
    }
  }
}

Configuración: Windsurf

Añade Linkflare desde el panel de configuración MCP o edita ~/.codeium/windsurf/mcp_config.json. Si OAuth no está disponible en tu versión, usa el respaldo con clave de API de abajo.

{
  "mcpServers": {
    "linkflare": {
      "serverUrl": "https://mcp.linkflare.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "linkflare": {
      "serverUrl": "https://mcp.linkflare.io/mcp",
      "headers": {
        "Authorization": "Bearer ${env:LINKFLARE_API_KEY}"
      }
    }
  }
}

Configuración: Zed

Añade Linkflare como servidor de contexto personalizado en Zed. Cuando no hay una cabecera Authorization configurada, Zed inicia el flujo OAuth MCP estándar.

{
  "context_servers": {
    "linkflare": {
      "url": "https://mcp.linkflare.io/mcp"
    }
  }
}

Respaldo heredado para versiones antiguas de Zed o clientes sin soporte nativo para MCP remoto:

{
  "context_servers": {
    "linkflare": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linkflare.io/mcp"]
    }
  }
}

Datos de conexión

Ajuste	Valor
URL del endpoint	`https://mcp.linkflare.io/mcp`
Transporte	Streamable HTTP
Autenticación	Token Bearer mediante la cabecera `Authorization`
Cabecera de autenticación	`Authorization: Bearer YOUR_API_KEY`

Alternativa: Algunos clientes usan en su lugar una cabecera x-api-key. Linkflare acepta ambas.

Herramientas disponibles

Una vez establecida la conexión, tu asistente de IA dispone de las siguientes herramientas. No tienes que memorizarlas: solo habla con naturalidad y la IA elige la adecuada.

Herramientas de marcadores

Herramienta	Qué hace
add_link	Guardar un marcador, opcionalmente con colección, etiquetas, notas y tipo
add_links_from_text	Extraer y guardar todas las URL de un bloque de texto pegado
search_links	Buscar marcadores con filtros (texto, colección, etiquetas, tipo, bandeja de entrada, valoración)
get_link	Obtener todos los detalles de un marcador concreto
update_link	Actualizar el título, las notas, las etiquetas u otras propiedades de un marcador
delete_link	Eliminar un marcador
move_links	Mover uno o varios marcadores a otra colección
rate_link	Valorar un marcador con el pulgar hacia arriba o hacia abajo
get_inbox	Listar todas las entradas de la bandeja de entrada

Herramientas de organización

Herramienta	Qué hace
list_collections	Ver todas tus colecciones en forma de árbol
create_collection	Crear una nueva colección
list_tags	Ver todas tus etiquetas
create_tag	Crear una nueva etiqueta

Herramientas de conocimiento Pro

Las tarjetas de conocimiento son notas jerárquicas de texto enriquecido (piensa en Notion / Obsidian) que se pueden vincular con tus marcadores y repasar con repetición espaciada. Estas herramientas requieren un plan Pro.

Herramienta	Qué hace
search_knowledge	Buscar tarjetas de conocimiento por palabra clave en el título, el contenido y las etiquetas
add_knowledge	Crear una nueva tarjeta de conocimiento, opcionalmente con contenido, etiquetas, tarjeta superior y color
get_knowledge	Obtener una tarjeta por su ID con su contenido completo y la navegación de migas de pan superiores
update_knowledge	Actualizar el título, el contenido, las etiquetas, la tarjeta superior o el color de una tarjeta
delete_knowledge	Eliminar una tarjeta. Atención: elimina también todas las tarjetas secundarias anidadas.
list_knowledge_children	Explorar la jerarquía: listar las tarjetas raíz o las tarjetas secundarias de una tarjeta concreta

Prompts de IA

Estas son plantillas de prompt prediseñadas que tu IA puede usar para flujos habituales:

Prompt	Qué hace
organize_inbox	Obtener sugerencias para organizar las entradas de tu bandeja de entrada
summarize_collection	Resumir el contenido de una colección
find_related	Encontrar marcadores sobre un tema concreto
weekly_digest	Obtener un resumen de los marcadores guardados recientemente
suggest_tags	Obtener sugerencias de etiquetas para marcadores sin etiquetas
explore_knowledge Pro	Buscar en tu base de conocimiento sobre un tema, resumir lo capturado y resaltar lagunas

Resolución de problemas

Error «Unauthorized" o «Missing authentication"

Vuelve a comprobar tu clave de API. En la app de Linkflare, haz clic en tu menú de usuario (arriba a la derecha) y elige Copiar clave de API para copiar la clave exacta. Asegúrate de que no haya espacios de más y de que esté la clave completa.

Las herramientas no aparecen en Claude Desktop

Asegúrate de haber cerrado Claude Desktop por completo (no solo de haber cerrado la ventana) y de haberlo vuelto a abrir.
Vuelve a comprobar que el nombre del connector es linkflare y que la URL es exactamente https://mcp.linkflare.io/mcp (sin barra final).
Verifica que el OAuth Client ID en Advanced settings está puesto en linkflare-claude.

Sin resultados en la búsqueda

La búsqueda es de texto completo. Si una consulta no devuelve resultados, prueba con términos más generales. También puedes filtrar por colección, etiquetas o tipo en lugar de por texto.

Colección o etiqueta no encontrada

Puedes usar nombres de colección y de etiqueta (no solo IDs). La coincidencia de nombres no distingue entre mayúsculas y minúsculas, así que funcionan tanto «recetas" como «Recetas".

Las herramientas de conocimiento devuelven «Forbidden" o «Pro plan required"

Las herramientas de conocimiento (search_knowledge, add_knowledge, get_knowledge, update_knowledge, delete_knowledge, list_knowledge_children y el prompt explore_knowledge) están restringidas a las cuentas Pro. Las herramientas de marcadores, colecciones y etiquetas funcionan en el plan gratuito. Realiza la mejora en la página de precios.

He eliminado una tarjeta de conocimiento, pero mis tarjetas secundarias han desaparecido

delete_knowledge actúa en cascada: eliminar una tarjeta superior borra todas las tarjetas anidadas debajo de ella. Si la IA se ofrece a eliminar una tarjeta con tarjetas secundarias, compruébalo bien antes de aceptar. Para ordenar sin perder las tarjetas secundarias, muévelas primero con update_knowledge (pon parent_id en 0 para la raíz o en el ID de otra tarjeta).

Privacidad y seguridad

Tu clave de API identifica tu cuenta. El servidor MCP solo accede a tus marcadores personales: no puede ver los datos de otros usuarios. Toda la comunicación está cifrada mediante HTTPS.

El asistente de IA solo ve lo que le pides. No tiene acceso permanente a tu biblioteca completa, salvo que lo solicites expresamente.