Conectar Claude, Cursor o ChatGPT a una base de conocimiento: guía paso a paso

Conectar un asistente como Claude, Cursor o ChatGPT a una base de conocimiento le permite hacer preguntas sobre sus propios documentos sin copiar y pegar nada ni salir del editor o del chat. Hay dos caminos técnicos para lograrlo: un servidor MCP (Model Context Protocol), pensado para clientes como Claude Desktop o Cursor, o una herramienta basada en API REST, que funciona con ChatGPT y con cualquier agente propio. A continuación le explicamos, paso a paso, cómo configurar cada opción, cómo autenticarse sin exponer sus claves y cómo comprobar que las respuestas citan de verdad sus fuentes.

Qué necesita antes de empezar

Antes de tocar ningún cliente de IA, el requisito previo es tener una base de conocimiento ya creada e indexada. En Kopik esto significa subir sus PDF, Word, texto o Markdown, dejar que el sistema los trocee e indexe para búsqueda híbrida, y decidir si la base será pública (listada en el catálogo, con pago por pregunta) o privada (solo accesible con sus propias claves). Una vez la base existe, necesita cuatro cosas más:

• Una base de conocimiento ya indexada, con al menos unos cuantos documentos de prueba cargados.
• Una clave API generada desde el panel de la base, o el endpoint MCP correspondiente.
• Un cliente compatible: Claude Desktop o Cursor para MCP, o cualquier cliente que soporte herramientas/function calling para la vía API (ChatGPT incluido).
• Claridad sobre el modo de respuesta que quiere: respuestas redactadas con pasajes citados, o solo los pasajes en bruto (modo «passages»).

Conectar mediante un servidor MCP (Claude, Cursor)

MCP es el protocolo que permite a un cliente de IA descubrir y usar herramientas externas (como una búsqueda en su base de conocimiento) de forma estandarizada, sin que usted tenga que programar nada. Si no conoce el protocolo en detalle, puede repasar qué es MCP y cómo funciona antes de seguir.

Qué es un servidor MCP, en una frase

Un servidor MCP es un pequeño programa que expone una o varias «herramientas» (por ejemplo, «buscar en mi base de conocimiento») que un cliente compatible puede invocar automáticamente cuando la conversación lo requiere, sin que usted tenga que copiar resultados a mano.

Paso a paso en Claude Desktop

1. Genere el endpoint MCP de su base desde el panel de Kopik, en la sección dedicada a desarrolladores de esa base concreta.
2. Abra la configuración de Claude Desktop y localice el archivo de configuración de servidores MCP (normalmente en formato JSON).
3. Añada una entrada nueva con el comando o la URL del servidor MCP de Kopik y su clave de autenticación.
4. Reinicie Claude Desktop para que detecte el nuevo servidor y lo liste entre las herramientas disponibles.
5. Haga una pregunta de prueba directamente en la conversación, por ejemplo «según mi base de conocimiento, ¿qué dice el documento X sobre…?», y compruebe que la herramienta se invoca y aparece citada.

Si su objetivo concreto es dar acceso de este tipo a toda su empresa (no solo a su propio equipo), conviene revisar antes cómo dar acceso a Claude a los documentos de su empresa, porque ahí se tratan además los matices de permisos y bases privadas frente a públicas.

Paso a paso en Cursor

1. Desde el panel de su base en Kopik, copie el endpoint MCP y la clave asociada.
2. En Cursor, abra la configuración de MCP del proyecto o del usuario y añada el servidor siguiendo el mismo patrón que en Claude Desktop.
3. Verifique que la herramienta aparece activa en el panel de herramientas del editor.
4. Pruebe una consulta desde el chat del editor, por ejemplo preguntando por una función, un error o una norma documentada en su base, y compruebe que la respuesta incluye el pasaje de origen.

Para un recorrido más detallado centrado específicamente en este editor, tiene la guía Cursor y MCP: cómo buscar en su documentación desde el editor. Y si quiere comparar Kopik con otros servidores MCP disponibles antes de decidirse, el artículo dónde encontrar servidores MCP y cómo elegir repasa los directorios y criterios habituales.

Conectar mediante API REST (ChatGPT y agentes propios)

ChatGPT, a fecha de hoy, no tiene un cliente MCP nativo tan directo como Claude Desktop o Cursor, por lo que la vía habitual es registrar la consulta a su base de conocimiento como una herramienta (tool o function calling) que el modelo puede invocar durante la conversación. Lo mismo aplica si está construyendo su propio agente con cualquier framework.

Generar su clave API

1. Entre en el panel de su base en Kopik y acceda a la sección de claves API.
2. Genere una clave nueva, asígnele un nombre descriptivo (por ejemplo «chatgpt-produccion») y guárdela en un gestor de secretos, nunca en texto plano dentro del proyecto.
3. Revise en la documentación para desarrolladores el formato exacto del endpoint de preguntas y los parámetros disponibles (modo con fuentes citadas o modo «passages»).
4. Haga una primera llamada de prueba con una herramienta como curl o Postman antes de integrarla en ChatGPT, para confirmar que la clave funciona y que la respuesta trae los pasajes esperados.

Configurar la herramienta en ChatGPT (function calling)

Una vez la clave funciona, el patrón es siempre el mismo: define una función con un nombre claro (por ejemplo consultar_base_conocimiento), una descripción de cuándo debe usarse, y un parámetro de tipo texto para la pregunta del usuario. Cuando ChatGPT decide invocar esa función, su backend llama al endpoint de Kopik con la clave API, recibe la respuesta con los pasajes citados y se la devuelve al modelo para que la integre en su respuesta final. El trabajo pesado (buscar, trocear, indexar, expandir semánticamente los términos de la pregunta) ya lo ha hecho Kopik al crear la base; su integración solo necesita pasar la pregunta y mostrar la respuesta.

Autenticación y seguridad de las claves

Dar acceso a un asistente de IA a sus documentos internos exige la misma disciplina que dar acceso a cualquier otro sistema con datos sensibles. Algunas prácticas que conviene aplicar desde el primer día:

• Use claves distintas por entorno y por cliente (una para Claude Desktop, otra para su integración de ChatGPT, otra para pruebas), así puede revocar una sin afectar a las demás.
• Si la base contiene información confidencial de su empresa, manténgala en modo privado: solo usted y sus claves pueden consultarla, no aparece en el catálogo público.
• Rote las claves periódicamente y elimine de inmediato las que ya no use en ningún cliente activo.
• Revise los registros de consultas si su plan lo permite, para detectar un uso anómalo o un volumen de preguntas que no cuadra con su actividad habitual.
• Si su organización está sujeta al RGPD, trate el acceso de un asistente de IA a documentos con datos personales como trataría cualquier otro encargado de tratamiento: documente la base legal y revise qué se registra y durante cuánto tiempo.

Verificar que las respuestas citan de verdad sus fuentes

Conectar el asistente es solo la mitad del trabajo: la otra mitad es comprobar, sobre todo al principio, que las respuestas que recibe realmente provienen de sus documentos y no son una reformulación genérica del modelo. El método más fiable es pedir siempre el pasaje citado y contrastarlo manualmente con el documento original, al menos durante las primeras semanas de uso. Si quiere un protocolo más completo para esto, el artículo respuestas de IA con citas: cómo verificar una respuesta sobre sus documentos detalla exactamente qué comprobar y con qué frecuencia.

MCP o API REST: qué opción elegir

Errores habituales al conectar un asistente a una base de conocimiento

• Probar primero con una pregunta ambigua: empiece siempre con una pregunta cuya respuesta exacta ya conoce.
• Usar la misma clave API en todos los entornos, lo que dificulta revocar el acceso si un cliente se ve comprometido.
• No revisar el modo de respuesta: si necesita los pasajes en bruto para procesarlos usted mismo, active el modo «passages» en lugar del modo con respuesta redactada.
• Olvidar que una base pública en el catálogo de Kopik cobra por pregunta: si va a integrarla en un producto con mucho tráfico, calcule el coste antes de lanzarlo.

Una mirada rápida al conjunto

Tanto si su prioridad es trabajar más rápido dentro de Cursor, dar a su equipo un Claude que conoce los documentos internos, o montar un chatbot de ChatGPT que responda con fuentes citadas, el camino técnico se reduce a tres decisiones: crear la base, elegir MCP o API según el cliente, y verificar las citas antes de confiar en las respuestas en producción.