Conexiones MCP
El servidor MCP de Soyio ofrece una interfaz estándar para que modelos y agentes de IA compatibles accedan a datos y operaciones de Soyio de forma simple y segura.
Conecta Soyio directamente en clientes como Claude, Cursor, OpenCode y Codex, o usa mcp-remote para clientes que todavía no soportan servidores MCP remotos de forma nativa.
Qué es Soyio MCP
Soyio MCP es un servidor hospedado y administrado por Soyio. Expone herramientas para consultar, crear y actualizar recursos de Soyio desde clientes compatibles con Model Context Protocol.
El servidor usa MCP remoto por Streamable HTTP y autorización interactiva. Cada conexión se aprueba desde el dashboard de Soyio, con permisos y entorno definidos por tu empresa.
Si solo quieres conectar un cliente, empieza por configurar clientes MCP. Vuelve a esta página cuando necesites entender permisos, entornos o superficies disponibles.
Por qué usar Soyio MCP
- Configuración rápida: conecta clientes compatibles usando OAuth y el endpoint hospedado de Soyio.
- Acceso controlado: define si la conexión usa permisos del usuario o acceso completo administrado.
- Entornos separados: autoriza conexiones para sandbox o producción según el caso de uso.
- Herramientas listas para agentes: opera plantillas, workflows, solicitudes de derechos, consentimientos, disclosures y validaciones con respuestas estructuradas.
Qué puedes hacer
- Revisar configuración de compañía: consultar usuarios, productos, sucursales, documentos de privacidad y permisos disponibles.
- Gestionar consentimientos: crear y actualizar plantillas, revisar acciones, commits, correcciones, revocaciones y métricas.
- Trabajar con disclosures: administrar plantillas y analizar solicitudes de disclosure.
- Resolver solicitudes de derechos: listar, crear y resolver DSRs desde flujos asistidos por IA.
- Operar workflows: crear, actualizar, publicar, ejecutar y auditar workflows de Soyio.
- Analizar validaciones: revisar intentos de validación y estadísticas agregadas.
Superficies MCP
Soyio MCP tiene tres superficies principales:
| Superficie | Qué ofrece | Cuándo usarla |
|---|---|---|
| Herramientas | Operaciones ejecutables como soyio_list_products o soyio_create_workflow | Cuando el agente necesita leer o modificar datos de Soyio |
| Recursos | Guías y catálogos consultables por el cliente MCP | Cuando el agente necesita contexto sobre herramientas, cobertura o buenas prácticas |
| Prompts | Plantillas de conversación para tareas frecuentes | Cuando quieres guiar al agente en creación de consentimientos o workflows |
Consulta la referencia de herramientas para ver módulos, toolsets, recursos, prompts y ejemplos de uso.
Puedes limitar las herramientas visibles para un cliente con ?toolsets=... en la URL. La referencia de herramientas explica cómo declarar toolsets y qué incluye cada módulo.
Cómo funciona la autorización
- Configuras el endpoint MCP en tu cliente.
- El cliente descubre el flujo de autorización de Soyio automáticamente.
- Soyio abre una pantalla de autorización en el dashboard.
- El usuario revisa el cliente, el modo de acceso y el entorno.
- Soyio emite un token MCP para esa conexión.
- El cliente usa ese token para llamar al servidor MCP hospedado.
Los códigos pendientes expiran después de 10 minutos. Si el código expira, inicia la conexión nuevamente desde el cliente. Para instrucciones por cliente, usa la guía de configuración.
Modos de acceso
Permisos del usuario
Este modo deriva los permisos desde los roles actuales del usuario que autorizó la conexión. Si la empresa deshabilita MCP, las conexiones existentes quedan pausadas hasta que vuelva a habilitarse.
Úsalo para clientes personales o flujos donde cada usuario debe conservar los límites de acceso del dashboard.
Acceso completo
Este modo crea una conexión administrada por un usuario con permiso dashboard.manage. Internamente, Soyio genera credenciales de API administradas para esa conexión.
Úsalo solo para integraciones de confianza que necesiten operar toda la superficie MCP habilitada.
Puedes revisar y revocar conexiones existentes desde Configuración > MCP en el dashboard.
El acceso completo puede ejecutar acciones de escritura si la conexión tiene toolsets habilitados para ello. Úsalo para integraciones administradas, no para clientes personales.
Entornos
Durante la autorización eliges si la conexión opera sobre sandbox o producción.
- Usa sandbox para probar clientes, prompts y automatizaciones sin afectar registros reales.
- Usa producción solo cuando el cliente y sus permisos ya estén validados.
- Crea conexiones separadas para sandbox y producción.
Antes de autorizar producción, valida el cliente en sandbox y revisa la guía de paso a producción para confirmar que tu integración está lista.
Siguiente paso
Sigue la guía de configuración de clientes para conectar tu herramienta de IA a Soyio.