Servidor MCP

Ryvo tiene un servidor remoto de Model Context Protocol. Conéctalo a tu asistente de IA y podrás pedirle en lenguaje natural cosas como «¿cuántas llamadas fallaron ayer y por qué?», «crea un agente para recordatorios de citas» o «enséñame la última conversación con este número», sin escribir código contra la API.


URL	`https://mcp.ryvo.so` (también responde en `https://mcp.ryvo.so/mcp`)
Transporte	Streamable HTTP, sin estado: no hay sesiones que mantener vivas
Protocolo	MCP `2026-07-28`, con respaldo para clientes de las revisiones de 2025
Autenticación	`Authorization: Bearer ryvo_live_...`
Plan	Starter o superior, igual que la API

El servidor no reimplementa la API: cada herramienta corre el mismo endpoint de la API pública dentro de nuestros servidores, con tu key y tu IP. Mismos datos, mismos scopes, mismos errores, mismos límites de peticiones, mismo tope de créditos.

Antes de empezar

Necesitas una API key. No hay una credencial aparte para el MCP: es la misma key ryvo_live_... que creas en Configuración > API keys (app.ryvo.so/developers). Cómo crearla está en Autenticación. Crea una key sólo para el MCP y elige sus scopes con cuidado:

El asistente sólo ve las herramientas que sus scopes permiten. Una key de sólo lectura ni siquiera ve create_call. La lista completa está en Herramientas.
En Configuración avanzada, ponle un Límite de créditos. Es la protección real contra un agente que gaste más de lo que querías: lee Seguridad y gasto.
Si el asistente va a leer transcripciones sin que tú lo supervises, dale una key de sólo lectura. Aquí explicamos por qué.

Después guarda la key en una variable de entorno en lugar de pegarla en un archivo de configuración:

export RYVO_API_KEY="ryvo_live_..."

Conecta tu cliente

Claude Code
Cursor
VS Code
Windsurf
Otros clientes

Para un proyecto, agrega un archivo .mcp.json en su raíz. Claude Code expande ${RYVO_API_KEY} desde tu entorno al arrancar, así que el archivo no guarda ningún secreto y puedes commitearlo:

.mcp.json

{
  "mcpServers": {
    "ryvo": {
      "type": "http",
      "url": "https://mcp.ryvo.so",
      "headers": {
        "Authorization": "Bearer ${RYVO_API_KEY}"
      }
    }
  }
}

O agrégalo desde la terminal, sólo para ti:

claude mcp add --transport http ryvo https://mcp.ryvo.so \
  --header "Authorization: Bearer $RYVO_API_KEY"

Aquí es tu shell quien expande la variable, así que la key misma queda guardada en tu configuración de Claude Code. Agrega --scope user para tener Ryvo en todos tus proyectos.

Edita ~/.cursor/mcp.json (todos tus proyectos) o .cursor/mcp.json (un proyecto). Cursor lee ${env:RYVO_API_KEY} de tu entorno:

mcp.json

{
  "mcpServers": {
    "ryvo": {
      "url": "https://mcp.ryvo.so",
      "headers": {
        "Authorization": "Bearer ${env:RYVO_API_KEY}"
      }
    }
  }
}

Agrega .vscode/mcp.json a tu workspace. Con una entrada en inputs, VS Code te pide la key la primera vez que arranca el servidor, oculta lo que escribes y la guarda de forma segura:

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "ryvo-api-key",
      "description": "API key de Ryvo",
      "password": true
    }
  ],
  "servers": {
    "ryvo": {
      "type": "http",
      "url": "https://mcp.ryvo.so",
      "headers": {
        "Authorization": "Bearer ${input:ryvo-api-key}"
      }
    }
  }
}

Windsurf ahora se llama Devin Desktop, y su agente por omisión (Devin Local) lee los servidores MCP de ~/.config/devin/mcp_config.json (en Windows, %APPDATA%\devin\mcp_config.json). Para un solo proyecto, usa .devin/mcp_config.json, o .devin/mcp_config.local.json para dejarlo fuera de git. Lee ${env:RYVO_API_KEY} de tu entorno:

mcp_config.json

{
  "mcpServers": {
    "ryvo": {
      "url": "https://mcp.ryvo.so",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer ${env:RYVO_API_KEY}"
      }
    }
  }
}

Funciona cualquier cliente MCP que hable Streamable HTTP y te deje poner un header en la petición. Dale:

URL: https://mcp.ryvo.so
Header: Authorization: Bearer ryvo_live_...

Próximamente: la CLI de Ryvo (@ryvo-so/cli) escribirá esta configuración por ti con ryvo mcp install.

Clientes que todavía no funcionan

La versión 1 se autentica sólo con header. Todavía no hay inicio de sesión con OAuth, así que no pueden conectarse los clientes que sólo agregan servidores remotos con un conector OAuth: eso incluye los conectores de claude.ai y ChatGPT. OAuth está planeado para una fase posterior. Por lo mismo, una key que falta o no sirve recibe un 401 normal con el error JSON de la API, sin la cabecera WWW-Authenticate que apunta a metadatos de OAuth: tu cliente te enseña el error en vez de abrir una página de inicio de sesión que no existe.

Comprueba la conexión

Reinicia tu cliente o recarga sus servidores MCP (en Claude Code, /mcp muestra el estado de cada uno).
Pídele al asistente que «llame a get_account». Te responde con tu cuenta, tu plan y los scopes que trae la key. Para tu saldo de créditos, get_billing_summary (pide billing:read).
Si el servidor no conecta, prueba la key sola con curl https://api.ryvo.so/v1/me -H "Authorization: Bearer $RYVO_API_KEY". Un 401 quiere decir que la key está mal o fue revocada, o que el header no está escrito como Bearer más la key.

Si falta una herramienta que esperabas, a la key le falta su scope: compárala con la tabla de Herramientas.

Empezar

Conceptos

Webhooks

Línea de comandos

Servidor MCP

Antes de empezar

Conecta tu cliente

Clientes que todavía no funcionan

Comprueba la conexión

​Antes de empezar

​Conecta tu cliente

​Clientes que todavía no funcionan

​Comprueba la conexión

Antes de empezar

Conecta tu cliente

Clientes que todavía no funcionan

Comprueba la conexión