Conectar el MCP

El MCP (Model Context Protocol) es la forma de editar canvases conversando con un asistente de IA en lugar de usar el editor visual. Conectás Claude Desktop, Cursor o ChatGPT a Runia, y ahí mismo le pedís cosas como:

• "Abrí el canvas de reservas y agregame un nodo que pida el número de personas."
• "En el canvas de Fudy, conectá la salida de error del agente a un mensaje de disculpa."
• "Validá el canvas y si está todo bien, publicalo."

El asistente entiende el canvas, llama a las herramientas del MCP para modificarlo y te muestra los cambios. Vos aprobás o pedís ajustes.

Antes de empezar

Dos cosas que tenés que tener:

• Rol de Partner o Super Admin en Runia. Los usuarios comunes no pueden conectar apps por MCP. Si no estás seguro, preguntale al equipo de Runia.
• Un cliente MCP instalado. Los más comunes:
  • Claude Desktop (Mac o Windows) — el más probado.
  • Cursor — ideal si ya lo usás para código.
  • ChatGPT u otros compatibles con MCP.

Dónde se gestionan las conexiones

En el panel: Configuración → Conexiones MCP.

Esta página tiene tres partes:

• URL del servidor: el único dato que tu cliente MCP necesita.

  https://bo-api.runia.ar/mcp

  No hay API key que copiar. La autorización es por OAuth: tu cliente te redirige al panel, iniciás sesión como siempre y autorizás.
• Conexiones activas: lista de las apps que ya están conectadas.
• Botones por conexión: Renombrar, Excluir empresas y Revocar.

Conectar Claude Desktop

Se hace desde la propia interfaz, sin tocar archivos de configuración.

1. En el sidebar izquierdo, tocá Customize.

2. Elegí Conectores y después tocá el botón + al lado del buscador. Del menú que se despliega, elegí Agregar conector personalizado.

3. En el modal, completá:
   • Nombre: Runia (o como quieras llamarlo).
   • URL del servidor MCP remoto: https://bo-api.runia.ar/mcp.

4. Tocá Agregar. Claude abre una ventana que te redirige a Runia para autorizar.
5. Iniciás sesión (si no lo estabas) y tocás Autorizar.

Desde ese momento, Claude puede hablar con Runia. Probá con:

"Listá mis empresas cliente."

Si el MCP está bien conectado, te devuelve la lista de empresas que referencias.

{
  "mcpServers": {
    "runia": {
      "url": "https://bo-api.runia.ar/mcp"
    }
  }
}

Conectar Cursor

1. Abrí Cursor → Settings → MCP.
2. Agregá un servidor con:
   • Name: runia
   • URL: https://bo-api.runia.ar/mcp
3. Guardá. Cursor te abre la ventana de autorización.
4. Iniciás sesión y autorizás.

El flujo después es el mismo: preguntás en el chat y Cursor usa las herramientas de Runia.

Conectar Codex

Codex te deja agregar servidores MCP desde su panel de configuración, sin tocar archivos a mano.

1. Abrí Codex. Vas a ver la pantalla principal con el chat.

2. Tocá tu avatar arriba a la derecha y elegí Configuración.

3. Se abre la ventana de configuración. En el sidebar izquierdo, entrá a Servidores MCP.

4. La primera vez no hay servidores conectados. Tocá Agregar servidor.

5. En el modal, completá:

   • Nombre: Runia (o como quieras llamarlo).
   • Tipo de conexión: HTTP secuenciable.
   • URL: https://bo-api.runia.ar/mcp.

   Los demás campos (variable de entorno del token, encabezados) los dejás vacíos. Runia usa OAuth, no necesita token manual.

6. Tocá Guardar. El servidor aparece en la lista con un botón Autenticarse. Tocalo.

7. Codex abre el navegador y te lleva a la pantalla de consentimiento de Runia. Iniciás sesión si hace falta y elegís a qué empresas le das acceso.

8. Tocá Autorizar conexión.

9. Listo. Volvés a Codex y el servidor queda activo con el toggle en azul.

Desde ahí, probás lo mismo que con cualquier otro cliente:

"Listá mis empresas cliente."

Cómo funciona el OAuth

El MCP no usa API keys. En su lugar, cada vez que un cliente se conecta por primera vez:

1. El cliente te redirige a Runia para iniciar sesión.
2. Runia te muestra una pantalla de consentimiento con qué app está pidiendo acceso.
3. Vos autorizás.
4. Runia le devuelve un token al cliente.
5. Ese token queda guardado en el cliente MCP y se renueva solo mientras esté activo.

Si no confías en la app, desde la página de Conexiones MCP la podés revocar en cualquier momento. El token deja de funcionar al instante.

Alcance de una conexión

Una conexión MCP te da acceso a todas las empresas cliente que tengas como partner. Cuando le pedís al asistente "mostrame los canvases", te lista los de todos tus clientes.

Trabajar con una empresa específica

La primera herramienta que el asistente siempre llama en una sesión nueva es list_client_companies. Ahí ve el id de cada empresa. De ahí en más, cuando vos decís "el canvas de Fudy", el asistente sabe a qué company_id apuntar.

Si decís un nombre que no matchea con ninguna empresa autorizada, el asistente te devuelve la lista para que elijas.

Excluir empresas de una conexión

Si querés que una conexión específica no pueda tocar una empresa (por ejemplo, porque la estás por entregar al cliente final y no querés más ediciones desde Claude), entrás a la página de Conexiones MCP, tocás la conexión y agregás la empresa a Excluir empresas.

La conexión sigue funcionando para las demás, pero esa empresa queda off-limits para ese cliente MCP.

Qué puede hacer el asistente

Con la conexión activa, el asistente tiene acceso a estas herramientas:

Inspeccionar un canvas:

• list_canvases → qué canvases tiene la empresa.
• get_canvas_summary → resumen de nodos y edges.
• get_node, get_edges → detalle fino.

Editar un canvas (en el borrador):

• add_node, update_node, remove_node → nodos.
• add_edge, remove_edge → conexiones.
• edit_node_text, patch_node → ediciones puntuales.

Publicar:

• validate_canvas → chequeo antes de publicar.
• publish_canvas → publica la versión actual.

Consultar el ecosistema:

• list_integrations → qué integraciones tiene conectadas esa empresa.
• list_voices → voces disponibles para nodos de voz.
• list_templates → plantillas de canvas que vienen con Runia.
• get_node_schema → documentación de los tipos de nodo disponibles.
• get_prompting_guide → buenas prácticas de prompts.
• get_integration_guide → cómo usar cada integración desde el canvas.

Crear desde plantilla:

• create_from_template → nuevo canvas basado en una plantilla (restaurante, ecommerce, FAQ, etc.).

Buenas prácticas trabajando con el MCP

• Empezá con contexto. Antes de pedir cambios, pedile al asistente que te resuma el canvas: "mostrame el flujo actual del canvas de turnos". Así vos y el asistente arrancan en la misma página.
• Iterá en chico. Cambios grandes (reescribir un canvas entero) salen mejor fraccionados: pedí primero la estructura, después el primer nodo, después el siguiente.
• Validá antes de publicar. El MCP tiene validate_canvas justamente para eso. Si el validator encuentra errores (salidas desconectadas, nodos huérfanos, valores inválidos), arreglalos antes de publicar.
• Usá las plantillas. Si tu cliente es un restaurante, ecommerce, inmobiliaria, probablemente hay una plantilla. Arrancar de una plantilla y customizar es mucho más rápido que escribir de cero.
• Aprovechá get_prompting_guide y get_node_schema. Son la referencia que el asistente usa para saber qué es válido. Si el asistente se equivoca con algún nodo, pedile que relea esa referencia y pruebe de nuevo.

Gestionar conexiones existentes

Desde Configuración → Conexiones MCP podés:

• Renombrar una conexión (útil si tenés varias, ej: "Claude trabajo", "Claude casa").
• Excluir empresas de una conexión específica.
• Revocar una conexión. El token muere al instante y el cliente MCP deja de tener acceso.

Si perdés el control de un cliente MCP (te robaron la laptop, te echaste a una persona del equipo que la tenía conectada), revocar la conexión desde acá cierra el acceso inmediatamente.

Próximo paso

Con el MCP conectado, el siguiente paso es armar tu primer canvas y editarlo conversando. Esa página viene pronto; mientras tanto, un buen ejercicio es pedirle al asistente que te liste las plantillas disponibles y explorar cómo está armada alguna (por ejemplo, la de restaurante o FAQ).