Conecta MCP usando conectores personalizados

Los conectores personalizados te permiten establecer una conexión segura entre tu base de conocimientos y asistentes de IA compatibles con MCP, como Cursor, IDE y Copilot. Una vez conectado, el asistente de IA puede interactuar con el contenido de la documentación en tu proyecto Document360 a través de MCP.

Dependiendo de tu asistente de IA, utiliza uno de los siguientes:

• URL del servidor MCP - Úsala cuando tu asistente de IA acepte una URL directa para la configuración del conector (por ejemplo, Copilot).
• Configuración JSON - Úsala cuando tu asistente de IA requiera un archivo de configuración estructurado (por ejemplo, el IDE del cursor).

Antes de que empieces

• Asegúrate de que MCP esté habilitado en tu proyecto Document360. Para los pasos que permiten activar MCP, consulta la página de Connect MCP a tu asistente de IA .
• Tienes acceso a un asistente de IA que soporta configuraciones MCP o conectores personalizados.

Consigue la configuración JSON

Para obtener los detalles de configuración,

1. Navega a Configuración () en la barra de navegación izquierda.

2. Ve a Configuración de IA > MCP.

3. En Conectores Personalizados, haz clic en Obtener detalles.

   

4. Se mostrará la configuración del MCP.

5. Puedes copiar la configuración completa de JSON o usar la URL proporcionada en ella, dependiendo de los requisitos de tu asistente de IA.

   Esta configuración es necesaria para establecer la conexión MCP en tu asistente de IA.

URLs de servidores MCP

Utiliza las siguientes URLs de servidores MCP al configurar conectores en tu asistente de IA. Selecciona la URL adecuada según la región o entorno de tu proyecto. Pega la URL en el campo de configuración del conector personalizado MCP en tu asistente de IA.

Cursor IDE

Para conectar MCP en el IDE de cursor:

1. Abre el cursor IDE.
2. Navega a Configuración.
3. Ve a Herramientas y MCP.
4. Haz clic en Añadir nuevo servidor MCP.

Serás redirigido a la pantalla de configuración del MCP.

1. Pega la configuración JSON de MCP copiada de Document360.
2. Guárdatelo.

Después de guardar:

1. Volver a Configuración del cursor del IDE > herramientas y MCP.
2. Localiza el servidor MCP configurado.
3. Una vez habilitada la autenticación, haz clic en Conectar.

Después de crear la conexión:

1. Serás redirigido a Document360.
2. Revisa la solicitud de conexión y elige el proyecto requerido.
3. Selecciona la casilla de confirmación (entiendo y confío en esta URL).
4. Haz clic en continuar.

La conexión ya está establecida. Puedes usar las capacidades MCP directamente dentro del IDE de Cursor para buscar, recuperar y actualizar documentación mientras codificas.

Copiloto

Para conectar MCP en agentes Copilot:

Crea un nuevo agente

1. Inicia sesión en tu entorno de Copilot.
2. Navega a Agentes.
3. Haz clic en Crear agente en blanco.
4. Introduce el nombre del agente.
5. Haz clic en Crear.

Serás redirigido al agente recién creado.

Añadir MCP como herramienta

1. En la página del agente, ve a la pestaña Herramientas en la barra de navegación superior.
2. Haz clic en Añadir una herramienta.
3. Selecciona Protocolo de Contexto del Modelo.

Configurar los ajustes de MCP

1. Introduce los siguientes detalles:
   • Nombre – Proporcionar un nombre para el conector MCP
   • Descripción – Introduce una descripción (mínimo 30 caracteres)
   • URL – Pegar la URL del servidor MCP correspondiente
2. En Método de autenticación, selecciona OAuth 2.0.
3. Asegúrate de que el Descubrimiento Dinámico esté seleccionado por defecto.
4. Haz clic en Crear.

Establecer conexión

1. Después de crear la herramienta, aparecerá una pantalla de Conexión que muestra No conectado.
2. Haz clic en No conectado.
3. Selecciona Crear nueva conexión.
4. Haz clic en Crear.

Después de crear la conexión:

1. Serás redirigido a Document360.
2. Revisa la solicitud de conexión y elige el proyecto requerido.
3. Selecciona la casilla de confirmación (entiendo y confío en esta URL).
4. Haz clic en continuar.

La conexión ya está establecida. El agente de Copilot puede interactuar con tu base de conocimientos utilizando las capacidades MCP habilitadas en tu proyecto.

Otras plataformas compatibles con MCP

Puedes conectar cualquier otro asistente de IA que soporte MCP o conectores personalizados usando los mismos detalles de configuración:

1. En tu asistente de IA, localiza la opción de añadir un servidor MCP o un conector personalizado.
2. Proporciona la URL del servidor MCP o la configuración JSON de Document360, dependiendo de lo que requiera la plataforma.
3. Completa la autenticación OAuth cuando redirijas a Document360: elige el proyecto requerido, selecciona la casilla Entiendo y confío en esta URL , y haz clic en Continuar.

Verifica la conexión

Para confirmar que tu asistente de IA puede acceder a tu base de conocimiento:

1. Inicia una nueva conversación con tu asistente de IA.
2. Introduce un aviso que le pida que busque o busque en tu documentación. Por ejemplo, pídele que busque un artículo por título o actualice una sección y luego publícalo en tu base de conocimientos.
   Si la conexión tiene éxito, el asistente de IA devuelve resultados obtenido de tu base de conocimientos Document360. Para más prompts que puedes probar, consulta el artículo sobre casos de uso de MCP .

Si no se devuelve ningún resultado o aparece un error, verifica:

• MCP está habilitado en Document360.
• La configuración JSON o la URL del servidor se copiaron correctamente.
• El conector está activo en tu asistente de IA.
  Si el problema persiste, vuelve a autenticar desconectando y reconectando el conector MCP, o contacta con el soporte de Document360.