Saltar al contenido principal

Configura clientes MCP

Esta guía muestra cómo conectar un cliente compatible con MCP al servidor hospedado de Soyio. Si necesitas entender permisos, entornos o modos de acceso antes de configurar un cliente, revisa la introducción a MCP.

Endpoint​

Usa este endpoint en clientes compatibles con MCP remoto por Streamable HTTP:

https://mcp.soyio.id/mcp

Los clientes compatibles descubren el flujo de autorización de Soyio automáticamente y redirigen al dashboard para aprobar la conexión.

Mantén el nombre del servidor como soyio si usarás una sola conexión. Si quieres separar superficies, usa nombres como soyio-workflows o soyio-consents y declara toolsets distintos en cada URL.

Elige toolsets desde la URL​

Agrega toolsets a la URL cuando quieras limitar qué herramientas ve el cliente. Por ejemplo:

{
  "mcpServers": {
    "soyio-workflows": {
      "url": "https://mcp.soyio.id/mcp?toolsets=workflows"
    },
    "soyio-consents": {
      "url": "https://mcp.soyio.id/mcp?toolsets=core,consents"
    }
  }
}

El parámetro toolsets solo limita herramientas disponibles para esa URL. No agrega permisos nuevos ni habilita módulos que la conexión no tenga autorizados. Consulta la referencia de herramientas para ver todos los ejemplos.

Sin toolsets, el cliente ve todos los toolsets autorizados para esa conexión. ?toolsets=all expresa lo mismo de forma explícita. Usa listas específicas, como ?toolsets=core,workflows, para reducir contexto en clientes de código.

Antes de conectar​

  1. Entra al dashboard de Soyio.
  2. Abre Configuración y luego MCP si el enlace no te lleva directamente a esa sección.
  3. Habilita MCP para la empresa si aún está deshabilitado.
  4. Confirma qué entorno vas a autorizar: sandbox o producción.
  5. Confirma qué modo de acceso corresponde. Si tienes dudas, revisa modos de acceso.

Autoriza producción solo desde clientes que ya probaste en sandbox. Si cambias de entorno o modo de acceso, revoca la conexión y crea una nueva.

Configura clientes​

La configuración exacta depende del cliente MCP. Usa el endpoint hospedado cuando el cliente soporte servidores remotos; usa mcp-remote cuando el cliente solo acepte servidores locales por comando.

Elige tu cliente y los toolsets para generar la URL y el comando de instalación listos para copiar.

Autoriza en Soyio​

Cuando el cliente inicie la autorización, Soyio abrirá una pantalla del dashboard. Revisa:

  • El cliente que quiere conectarse
  • El modo de acceso: permisos del usuario o acceso completo
  • El entorno: sandbox o producción
  • La etiqueta de la conexión para reconocerla después

Autoriza la conexión y vuelve al cliente. Los códigos pendientes expiran después de 10 minutos.

Si el cliente no vuelve automáticamente después de autorizar, regresa al cliente y ejecuta su comando de estado o login. En OpenCode, por ejemplo, usa opencode mcp list.

Uso avanzado con token bearer​

Algunos clientes o integraciones permiten configurar el token manualmente. Usa este patrón solo cuando no puedas usar el flujo interactivo.

No pegues tokens MCP en chats, tickets, repositorios ni prompts. Trátalos como credenciales de acceso a Soyio.

{
  "mcpServers": {
    "soyio": {
      "url": "https://mcp.soyio.id/mcp",
      "headers": {
        "Authorization": "Bearer mcp_example_token"
      }
    }
  }
}

Preguntas frecuentes​

El cliente no abre la autorización​

Verifica que el servidor esté configurado como remoto HTTP y que la URL termine en /mcp. Si el cliente no soporta servidores remotos, usa mcp-remote.

El código expiró​

Inicia otra conexión desde el cliente. Los códigos pendientes expiran después de 10 minutos.

El cliente muestra que Soyio está deshabilitado​

Revisa que el servidor esté habilitado en la configuración local del cliente y que MCP esté habilitado para la empresa en el dashboard de Soyio.

Quiero cambiar permisos o entorno​

Revoca la conexión actual y crea una conexión nueva con el modo de acceso y entorno correctos.

Quiero dejar de usar un cliente​

Revoca la conexión desde Configuración > MCP. El token deja de funcionar inmediatamente.