Integraciones y MCP
La página de Integraciones (/space/integrations) es una superficie de pestañas con cuatro secciones enlazables: Core, Servidores MCP, Plugins y Canales. Cada pestaña tiene su slug de URL (/core, /mcp, /plugins, /channels), así que cada sección es enlazable y el botón de atrás funciona.
¿Nuevo en el lado de IA? Lee primero Conceptos de IA desde cero — MCP y Llamadas a funciones/herramientas, que definen cómo los agentes obtienen herramientas externas.
Conectores Core
Sección titulada «Conectores Core»Código e Infraestructura
Sección titulada «Código e Infraestructura»| Conector | Auth | Notas |
|---|---|---|
| GitHub | OAuth | Repos, PRs, issues; impulsa las sesiones de workspace |
| GitLab | PAT (glpat-…, validado) |
Instancias self-hosted o cloud para CI/CD y repos |
| Cloudflare | API token (~40 caracteres, validado) | Desplegar agentes en Workers, gestionar DNS, acceder a R2 |
| Component Registry | Integrado | Buscar/previsualizar/instalar componentes UI del registro SynthHires vía MCP — reduce la alucinación con APIs de componentes reales |
Los tokens de servicio (GitLab, Cloudflare, Slack) se guardan en el vault local cifrado (synthhires-tokens, AES-GCM) — el estado siempre se deriva de la presencia real del token, nunca hardcodeado, y los tokens se validan antes de guardarse.
Datos y Mensajería
Sección titulada «Datos y Mensajería»| Conector | Auth | Notas |
|---|---|---|
| Supabase | Gestionado por plataforma | Postgres gestionado, Auth, Realtime — ya impulsa el workspace |
| Slack | Bot token (xoxb-…, validado) |
Notificaciones de agentes vía Slack Web API; los comandos entrantes viven en Canales |
Gestión de proyectos y protocolos
Sección titulada «Gestión de proyectos y protocolos»| Conector | Estado |
|---|---|
| Linear / Jira | Próximamente (basado en OAuth, zero-config) |
| Protocolo A2A | Próximamente — interoperabilidad Agente-a-Agente con cualquier agente compatible con A2A |
El concepto detrás de las integraciones: herramientas para agentes
Sección titulada «El concepto detrás de las integraciones: herramientas para agentes»Todas las páginas de integración sirven a un mismo objetivo: dar manos al modelo. Un modelo solo puede generar texto; para actuar (abrir un PR, consultar una base de datos, enviar un mensaje) necesita herramientas, entregadas como funciones invocables que el modelo puede llamar con argumentos estructurados. MCP es el socket estandarizado de esas herramientas — cualquier conector expone sus acciones (create_issue, search_issues, post_message) bajo una interfaz común que el modelo llama de forma uniforme. La plataforma ejecuta esas llamadas con su propia auth y consentimiento, y devuelve los resultados al contexto. Ver Conceptos de IA desde cero → Llamadas a funciones/herramientas y MCP para la explicación completa.
Servidores MCP
Sección titulada «Servidores MCP»La pestaña MCP (/space/integrations/mcp) gestiona los servidores del Model Context Protocol — el estándar para dar herramientas externas a los agentes. El registro (src/lib/mcp/registry.ts) incluye un catálogo curado de conectores:
| Conector | Categoría | Herramientas representativas |
|---|---|---|
| GitHub | code | create_issue, list_prs, get_file, search_code |
| GitLab | code | get_project, list_mr, create_mr, get_pipeline |
| Jira | project-management | get_issue, create_issue, search_issues, list_sprints |
| Asana | project-management | get_task, create_task, list_projects |
| Linear | project-management | get_issue, create_issue, list_issues |
| Notion | productivity | search, get_page, create_page, query_database |
| Slack | communication | post_message, list_channels, read_thread |
| Discord | communication | send_message, list_channels, get_guild |
Cada conector registra su paquete de servidor (p. ej. @modelcontextprotocol/server-github), modo de setup (token u OAuth) y una pista de conexión. El panel soporta buscar en el catálogo (searchConnectors) y sugerir conectores desde texto (suggestConnectorsForText) — pega una descripción y la plataforma propone los servidores relevantes.
El lado web usa un transporte MCP Streamable HTTP real en Workers (sin spawn de stdio). El registro MCP es local del cliente (localStorage), así que no necesita prefetch.
Plugins
Sección titulada «Plugins»La pestaña de Plugins (/space/integrations/plugins) gestiona el catálogo de plugins (PluginsTab en src/features/tools/components/plugins-tab.tsx). Los plugins extienden las herramientas de los agentes más allá de las integradas, instalables por workspace.
Canales
Sección titulada «Canales»La pestaña de Canales (/space/integrations/channels) gestiona los canales de mensajería entrantes — la superficie donde las plataformas externas (Slack, etc.) pueden enviar comandos hacia la plataforma, a diferencia de las notificaciones salientes del Core:
- Las conexiones de canal se cargan vía
prefetchChannelConnections, calentando la caché pronto para que el primer cambio de pestaña no pague latencia de compilación/red. - Cada canal soporta procesamiento de comandos entrantes, así que puedes manejar agentes desde tu herramienta de chat favorita.
Seguridad del almacenamiento de tokens
Sección titulada «Seguridad del almacenamiento de tokens»Todos los tokens de conectores siguen la misma regla que las API keys: cifrados localmente con AES-256-GCM en el vault del navegador, nunca almacenados en el servidor en texto plano. Desconectar elimina el token inmediatamente.