Configurar herramientas externas con servidores MCP

Añadir, gestionar y configurar servidores MCP para Cartographer, incluidos servidores personalizados, settings.json, y Apps MCP.

MCP es un protocolo abierto para conectar asistentes de IA a fuentes de datos y herramientas externas. A diferencia de los conectores de Integration Service, los servidores MCP pueden ser remotos (alojados en otro lugar, a los que se accede a través de HTTP) o locales (un programa que se ejecuta en tu máquina).

La mayoría de los servidores MCP no necesitan configuración manual: consulta la referencia de servidores MCP para el catálogo respaldado por Orchestrator y el mercado de terceros, los cuales añaden un servidor con un solo clic.

Añadir un servidor MCP personalizado

Para un servidor que no esté en el catálogo o mercado, añádelo manualmente desde Complementos e integraciones → Servidores MCP.

Servidores MCP remotos

Los servidores MCP remotos se alojan en otro lugar y se accede a ellos a través de HTTP:

1. Selecciona Añadir servidor MCP → Remoto.
2. Introduce los detalles del servidor:
   • URL: la dirección del punto final (por ejemplo, https://api.example.com/mcp)
   • Título: un nombre descriptivo (por ejemplo, "API de la empresa")
   • Encabezados (opcional): encabezados de autenticación, si es necesario
3. Selecciona Guardar.
4. Alternar Habilitado para activar.

Configuración de ejemplo:

{
  "type": "remote",
  "url": "https://internal-api.company.com/mcp",
  "enabled": true,
  "title": "Company Data API",
  "headers": {
    "Authorization": "<your-access-token>"
  }
}

Servidores MCP locales

Los servidores MCP locales se ejecutan como procesos en tu máquina:

1. Selecciona Añadir servidor MCP → Local.
2. Introduce los detalles del servidor:
   • Título: un nombre descriptivo
   • Comando: el ejecutable que se va a ejecutar (por ejemplo, node, python, /path/to/server)
   • Argumentos: argumentos de línea de comandos
   • Directorio de trabajo: donde se ejecuta el comando
   • Variables de entorno: pares clave-valor para el proceso
3. Selecciona Guardar.
4. Alternar Habilitado para activar.

Configuraciones de ejemplo

Servidor MCP del sistema de archivos:

{
  "type": "local",
  "enabled": true,
  "serverId": "filesystem-mcp",
  "title": "Local Filesystem Access",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"],
    "env": {},
    "cwd": "/Users/username"
  }
}

Servidor MCP de GitHub:

{
  "type": "local",
  "enabled": true,
  "serverId": "github-mcp",
  "title": "GitHub Integration",
  "config": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "<your-access-token>"
    },
    "cwd": "/Users/username"
  }
}

Gestión de servidores MCP

Desde Complementos e integraciones → Servidores MCP, puedes activar o desactivar un servidor configurado, editar su configuración o eliminarlo. Deshabilitar un servidor impide que el agente utilice sus herramientas, pero no detiene un proceso de servidor local que ya se está ejecutando; es posible que debas detener ese proceso tú mismo.

Cómo descubre el agente las herramientas de MCP

Cuando se habilita un servidor MCP, el agente se conecta a él, el servidor informa de sus herramientas disponibles y esas herramientas pasan a estar disponibles en la conversación, sin necesidad de registro manual. Puedes hacer referencia a ellos en lenguaje natural, por ejemplo: "Usar la herramienta del sistema de archivos para enumerar mi carpeta Documentos"

MCP Apps: interfaces interactivas en línea

MCP Apps es una extensión del Protocolo de contexto del modelo que permite que una herramienta devuelva una interfaz interactiva (un formulario, un panel, un gráfico, una tabla de datos) en lugar de solo texto. Cuando la herramienta de un servidor MCP conectado lo admite, Cartographer renderiza esa interfaz en línea en la conversación, en un marco aislado: la interfaz puede llamar a las propias herramientas del servidor y recibir actualizaciones, pero no puede acceder a nada fuera de su propio marco. Los formularios llegan precargados con valores sensibles, para que solo cambies lo que importa en lugar de describir cada campo en el chat.

Si un servidor MCP determinado ofrece esto depende de ese servidor: no todos los servidores implementan la extensión.

Los administradores pueden gobernar los servidores MCP en el nivel de política: consulta Servidores MCP en Gobernanza con Automation Ops.

Avanzado: gestión de la conexión a través de settings.json

Los usuarios avanzados pueden gestionar las conexiones del servidor MCP directamente en settings.json : la misma lista mcpServers que la IU lee y escribe:

{
  "mcpServers": [
    {
      "type": "remote",
      "url": "https://api.example.com/mcp",
      "enabled": true,
      "title": "Example API",
      "headers": {
        "Authorization": "<your-access-token>"
      }
    },
    {
      "type": "local",
      "enabled": true,
      "serverId": "my-local-server",
      "title": "Local Tools",
      "config": {
        "command": "python",
        "args": ["/path/to/server.py"],
        "env": { "API_KEY": "<your-api-key>" },
        "cwd": "/path/to/working/dir"
      }
    }
  ]
}

Edite settings.json solo si se siente cómodo con JSON: la sintaxis no válida impide que la aplicación se cargue. Haz siempre una copia de seguridad antes de editar. Consulta Ubicaciones de archivos de configuración.

Para consideraciones de seguridad e información sobre el flujo de datos para las conexiones, consulta Configuración de seguridad local.

Próximos pasos

• Referencia de servidores MCP : el catálogo de Orchestrator y el mercado de terceros
• Conexión a aplicaciones empresariales populares : para integraciones SaaS gestionadas
• Repetir trabajo con rutinas : guarda flujos de trabajo que utilizan tus herramientas conectadas
• Compartir habilidades con tu equipo : encuentra habilidades prediseñadas para tus servicios conectados