Recursos para desarrolladores

MCP alojado

Conecte Claude Desktop, Cursor, VS Code, Windsurf u otro cliente MCP a RunAPI con OAuth.

El MCP alojado es la forma recomendada de usar las herramientas de RunAPI. Su cliente MCP se conecta directamente a RunAPI, por lo que no necesita instalar Node.js ni mantener un proceso local en ejecución.

Usa este endpoint:

TEXT

https://mcp.runapi.ai/mcp

Elija su cliente MCP a continuación. Cuando el cliente abra RunAPI en su navegador, inicie sesión, seleccione la cuenta que desea usar y apruebe el acceso.

Claude Desktop

Abre Settings > Connectors y agrega un conector personalizado.
Nómbralo RunAPI e ingresa el endpoint indicado anteriormente.
Selecciona Connect y completa la autorización de RunAPI en tu navegador.
En una conversación, abre + > Connectors y habilita RunAPI.

Si RunAPI no aparece en una conversación, vaya a Configuración > Conectores, vuelva a conectarlo y confirme que está habilitado para esa conversación.

Cursor

Agrega RunAPI a tu mcp.json de Cursor, como el .cursor/mcp.json a nivel de proyecto:

JSON

{
  "mcpServers": {
    "runapi": {
      "url": "https://mcp.runapi.ai/mcp"
    }
  }
}

Abra Customize en la barra lateral de Cursor, encuentre RunAPI, habilítelo y complete la autorización en su navegador.

RunAPI debe aparecer como conectado y exponer sus herramientas. Si hay errores de conexión o Autenticación, abra el panel Salida y seleccione MCP Logs.

VS Code

Abre la paleta de comandos y ejecuta MCP: Add Server.
Elige HTTP, ingresa el endpoint indicado anteriormente y nombra el servidor RunAPI.
Inicia el servidor, confía en él cuando se te solicite y completa la autorización en tu navegador.

Las herramientas de RunAPI deberían aparecer en el Chat. Si hay errores, ejecute MCP: List Servers, seleccione RunAPI y elija Show Output.

Windsurf

Estos pasos se aplican al agente Cascade. Devin Local utiliza la configuración de Devin CLI.

Abre Devin Settings > Cascade > MCP Servers y edita directamente el archivo ~/.codeium/windsurf/mcp_config.json.
Agrega RunAPI como servidor HTTP remoto:

JSON

{
  "mcpServers": {
    "runapi": {
      "serverUrl": "https://mcp.runapi.ai/mcp"
    }
  }
}

Guarda el archivo, actualiza los servidores MCP, habilita RunAPI y completa la autorización en tu navegador.

Si las herramientas no aparecen, abra la configuración de MCP, confirme que RunAPI está habilitado y vuelva a conectarlo.

Otros clientes MCP

Agrega el endpoint anterior como servidor Streamable HTTP. El cliente debe ser compatible con Remote MCP y OAuth basado en navegador. Completa la autorización cuando se te solicite y luego habilita las herramientas de RunAPI en el cliente.

Verificar la conexión

Pregunta a tu cliente:

¿Qué modelos de imagen de RunAPI están disponibles?

El cliente debe llamar a list_models y devolver los modelos de imagen disponibles. Esto confirma que la conexión y el despacho de herramientas funcionan correctamente.

Usa una Clave de API en su lugar

OAuth es la ruta recomendada. Use una Clave de API estándar dedicada solo para un cliente desatendido o cuando OAuth no esté disponible; siga la Guía de Autenticación para crear una. Nunca ponga la clave en la URL del punto de conexión ni la confirme en un repositorio.

Claude Desktop: Si los encabezados de solicitud están disponibles para conectores personalizados, agrega un encabezado Authorization con el valor Bearer YOUR_API_KEY.
Cursor: Establece RUNAPI_API_KEY en el entorno visible para la aplicación Cursor y luego usa Authorization: Bearer ${env:RUNAPI_API_KEY} en los headers del servidor. Los servidores remotos no leen la configuración envFile de Cursor.
VS Code: Haz referencia a un ${input:...} de tipo contraseña desde el encabezado Authorization del servidor para que VS Code solicite y almacene la clave en lugar de escribirla en mcp.json.
Windsurf: Haz referencia a ${env:RUNAPI_API_KEY} o ${file:...} desde el encabezado Authorization en ~/.codeium/windsurf/mcp_config.json.

Revoque la clave desde la página de Claves de API cuando el cliente quede en desuso o cuando la clave pueda haber sido expuesta.

Solución de problemas

La autorización no se completó: reconecte RunAPI desde el cliente y complete el flujo del navegador nuevamente.
RunAPI está conectado pero sus herramientas no aparecen: confirme que el servidor está habilitado, elimine y vuelva a agregar el endpoint exacto y luego inicie una nueva conversación.
La pregunta de verificación falla: revise el registro del cliente descrito en su sección correspondiente y reconecte RunAPI antes de volver a intentarlo.

¿Necesita un cliente para iniciar RunAPI en su máquina? Configure MCP local.