Saltar al contenido
Recursos para desarrolladores
Recursos para desarrolladores

MCP local

Ejecute el servidor RunAPI MCP Server localmente con Claude Code, Cursor, VS Code, Windsurf u otro cliente stdio.

Ver Markdown

MCP local permite que su cliente MCP inicie el Servidor MCP de RunAPI en su máquina. Úselo cuando el cliente no admita MCP remoto o cuando necesite explícitamente un proceso local.

Antes de empezar

Instale Node.js y confirme que npx está disponible. Su cliente MCP debe admitir servidores stdio locales.

Cada cliente que se muestra a continuación inicia el mismo comando:

SHELL 
npx -y @runapi.ai/mcp

Puedes conectarte y usar las herramientas del catálogo sin iniciar sesión.

Claude Code

Ejecutar:

SHELL 
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp

Usa -s user para hacer que RunAPI esté disponible en todos tus proyectos. Reinicia Claude Code si ya estaba en ejecución y confirma que RunAPI aparece listado como servidor MCP.

Cursor

Agrega el servidor bajo mcpServers en .cursor/mcp.json o en tu configuración MCP de usuario:

JSON 
{
  "mcpServers": {
    "runapi": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/mcp"]
    }
  }
}

Abra Customize en la barra lateral de Cursor, encuentre RunAPI y habilítelo. Si el proceso no se inicia, abra el panel Output y seleccione MCP Logs.

VS Code

  1. Abre la paleta de comandos y ejecuta MCP: Add Server.
  2. Elige Command (stdio) e ingresa npx -y @runapi.ai/mcp.
  3. Nombra el servidor RunAPI, elige su ámbito de configuración e inícialo.
  4. Confía en el servidor cuando se te solicite. Si hay errores, ejecuta MCP: List Servers, selecciona RunAPI y elige Show Output.

VS Code almacena la configuración manual bajo la clave de nivel superior servers y usa type: "stdio".

Windsurf

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

  1. Abre Devin Settings > Cascade > MCP Servers.
  2. Abre la configuración MCP sin procesar en ~/.codeium/windsurf/mcp_config.json.
  3. Agrega RunAPI con el comando npx y los argumentos que se muestran en el ejemplo de Cursor anterior.
  4. Guarda el archivo, actualiza los servidores MCP y habilita RunAPI.

Otros clientes MCP

Agrega un servidor stdio local llamado RunAPI. Establece su comando en npx y sus argumentos en -y y @runapi.ai/mcp. Reinicia o actualiza el cliente después de guardar la configuración.

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. Esta herramienta de descubrimiento público no requiere autenticación.

Iniciar sesión cuando sea necesario

Siga usando las herramientas de descubrimiento sin iniciar sesión. Cuando solicite por primera vez a RunAPI que cree un task, recupere un task o compruebe un saldo, permita que el cliente llame a la herramienta login. Se abre RunAPI en su navegador y guarda la credencial en la configuración local compartida.

Si prefiere iniciar sesión desde un terminal, instale la CLI de RunAPI y ejecute:

SHELL 
runapi login

Para clientes sin interfaz gráfica o de integración continua, siga la Guía de Autenticación para crear una clave de API estándar dedicada y luego proporciónela como RUNAPI_API_KEY a través del entorno del cliente o de la configuración de secretos. Una clave de entorno tiene prioridad sobre la credencial guardada por el inicio de sesión MCP local.

Solución de problemas

  • No se encuentra npx: confirme que node --version y npx --version funcionan correctamente y reinicie por completo el cliente MCP para que reciba el entorno actualizado.
  • El servidor local se cierra de inmediato: ejecute npx -y @runapi.ai/mcp en una terminal, corrija el error de Node.js o del paquete indicado y reinicie el cliente.
  • Las herramientas de RunAPI no aparecen: confirme que el servidor está habilitado y que el comando usa stdio, y luego revise el registro del cliente descrito anteriormente.
  • Falla una herramienta autenticada: pida al cliente que llame a la herramienta login. Si RUNAPI_API_KEY está configurada, actualícela o elimínela antes de intentar el inicio de sesión MCP local nuevamente.

¿Prefiere una conexión sin un proceso Node.js local? Configure el MCP alojado.