Autorización: qué API elegir
~4 min · Dos transportes: /rpc (clave API) y /mcp (sesión MCP).
Ringostat ofrece dos formas de llamar a la API. La regla es sencilla:
- 1Una solicitud puntual desde tu backend → /rpc con la cabecera X-API-Key. Sin sesión, un solo POST.
- 2Un agente de IA / cliente MCP → /mcp con la misma clave en la cabecera Authorization: Bearer (o mediante OAuth): initialize → Mcp-Session-Id → tools/call. Los métodos se descubren con tools/list.
# /rpc — una sola solicitud
POST https://apiagent.ringostat.com/rpc
X-API-Key: <TU_CLAVE_API>
Content-Type: application/json
{ "jsonrpc":"2.0", "method":"getCampaignStatus",
"params":{ "projectID":217, "campaignID":799 }, "id":1 }# /mcp — primero el saludo, luego los métodos
POST https://apiagent.ringostat.com/mcp
Authorization: Bearer <TU_CLAVE_API>
Content-Type: application/json
Accept: application/json, text/event-stream
{ "jsonrpc":"2.0","id":1,"method":"initialize",
"params":{ "protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"my-app","version":"1.0.0"} } }
# → lee la cabecera Mcp-Session-Id de la respuesta
# 2) las mismas cabeceras + Mcp-Session-Id:
# { "jsonrpc":"2.0","method":"notifications/initialized" } → 202
# 3) tools/list y tools/call — con Mcp-Session-Id en cada solicitudLa respuesta llega como application/json o como text/event-stream (líneas data:; toma el objeto con el id de tu solicitud), así que mira el Content-Type de la respuesta. Sin Mcp-Session-Id o con uno desconocido el servidor responde 404: vuelve a ejecutar initialize.
La clave API se crea en el panel: proyecto → «Settings» → «API Keys» (solo administradores del proyecto). Una clave sirve en ambos transportes: X-API-Key en /rpc; Authorization: Bearer (o X-API-Key) en /mcp. /rpc no acepta Authorization: Bearer. Una clave solo abre su propio proyecto. La lista completa de métodos está en la sección «API».
Los clientes de IA con OAuth (Claude, ChatGPT, Cursor y otros) no necesitan clave: añade la dirección del servidor https://apiagent.ringostat.com/mcp e inicia sesión en Ringostat cuando el cliente lo pida. Ese acceso cubre todos los proyectos del usuario que lo aprobó.