Saltar al contenido

MCP

Inferray ejecuta un servidor Model Context Protocol, para que los clientes MCP —Claude Code, Codex, Cursor, Claude Desktop y otros— puedan llamar a los modelos de Inferray como herramientas desde una conversación. Pídele a tu asistente una segunda opinión de otro modelo, o que genere una imagen, sin salir del cliente.

  • URL — https://api.inferray.com/mcp
  • Transporte — Streamable HTTP
  • Autenticación — inicia sesión con OAuth o envía una clave de API como token Bearer

Esto es distinto de la API de inferencia: la URL se la das a un cliente MCP, no a un OpenAI SDK.

Herramientas

HerramientaQué hace
chatEnvía mensajes a cualquier modelo de texto y devuelve la respuesta.
list-modelsLista los modelos de texto disponibles y sus capacidades.
generate-imageGenera imágenes a partir de un prompt y las devuelve al cliente.
list-image-modelsLista los modelos de imagen que puede usar el proyecto.
generate-nano-bananaGenera una imagen con Gemini 3 Pro Image.
get-accountConsulta tu saldo restante y el uso de crédito.

Las llamadas a herramientas que ejecutan un modelo se cobran como cualquier otra solicitud al proyecto de la clave y aparecen en tus logs.

Claude Code

claude mcp add --transport http inferray https://api.inferray.com/mcp

Luego ejecuta /mcp en Claude Code y elige autenticarte; se abrirá una ventana del navegador para que apruebes el acceso. Para usar una clave en su lugar:

claude mcp add --transport http inferray https://api.inferray.com/mcp \
  --header "Authorization: Bearer $INFERRAY_API_KEY"

Cursor

En ~/.cursor/mcp.json, o en .cursor/mcp.json dentro de un proyecto:

{
  "mcpServers": {
    "inferray": {
      "url": "https://api.inferray.com/mcp",
      "headers": { "Authorization": "Bearer inferray_..." }
    }
  }
}

Omite headers para iniciar sesión con OAuth en su lugar.

Codex

En ~/.codex/config.toml:

[mcp_servers.inferray]
url = "https://api.inferray.com/mcp"
bearer_token_env_var = "INFERRAY_API_KEY"

Otros clientes

Funciona cualquier cliente que admita servidores MCP remotos mediante Streamable HTTP. Dale la URL; descubre los endpoints de OAuth a partir de /.well-known/oauth-protected-resource/mcp y te guía en el inicio de sesión. Los clientes que solo admiten servidores locales (stdio) necesitan un puente como mcp-remote.

Cómo funciona el inicio de sesión con OAuth

Cuando un cliente inicia sesión, apruebas el acceso en el navegador para el proyecto seleccionado actualmente en tu consola — cambia de proyecto primero si quieres otro. Después, el cliente recibe un token que solo funciona para el servidor MCP; no se puede usar como clave de API general. Los tokens duran una hora, después de lo cual el cliente te pide iniciar sesión de nuevo. Cada cliente conectado aparece en la página de claves de API como "MCP: " seguido del host del cliente; elimínalo ahí para revocar el acceso.

El servidor admite el transporte Streamable HTTP sin estado mediante POST. El transporte SSE anterior no está disponible.