Esta página se tradujo automáticamente del inglés. Lee el original en inglés.

Endpoint MCP

Una URL para cada cliente de IA

Apunta cualquier cliente de IA compatible con MCP a https://ai-game.dev/mcp y llegará al motor de juego que tengas abierto: Unity, Unreal Engine o Godot. Las herramientas, los prompts y los recursos se negocian al conectar el cliente, así que no hay ningún esquema que copiar.

URL del endpoint
https://ai-game.dev/mcp
Transporte
Streamable HTTP
Inicio de sesión
OAuth 2.1Clave de proyectoToken de acceso
Protocolo
MCP · JSON-RPC 2.0
Cómo funciona el inicio de sesión →Crear un token de acceso →Catálogo de herramientas →

La vía más rápida: deja que setup-mcp lo escriba

Cada CLI de motor escribe el archivo de configuración correcto para tu cliente: la URL fijada al proyecto más una clave de proyecto, para que el cliente conecte al instante sin nada que iniciar sesión. Añade --oauth para una configuración con solo la URL que inicia sesión a través del navegador. La app de escritorio hace lo mismo al configurar un proyecto.

# Unity — writes the pinned URL + a project key for Claude Code
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

# Unreal Engine (the project path is a flag)
unreal-mcp-cli setup-mcp cursor --path ./MyUnrealProject

# Godot, URL-only config that signs in over OAuth
godot-cli setup-mcp gemini ./MyGodotProject --oauth

Guías de instalación con el comando exacto para cada cliente: Unreal Engine · Unity · Godot

Iniciar sesión

OAuth 2.1 — inicio de sesión en el navegador, nada que pegar

Los clientes compatibles con la autorización de MCP inician sesión a través de tu navegador en la primera conexión (código de autorización con PKCE y registro dinámico de clientes) y luego conservan sus propios tokens. La configuración solo contiene la URL. El comando login de las CLI de motor usa en cambio el flujo de código de dispositivo: muestra un código que apruebas en el navegador.

Claves de proyecto — lo que escribe setup-mcp

Una clave de proyecto (agd_pk_…) pertenece a un proyecto y se envía como token bearer junto con la URL fijada. setup-mcp la crea y la escribe en la configuración del cliente, así que el cliente funciona sin inicio de sesión en el navegador. Si quitas un proyecto de tu cuenta, su clave deja de funcionar.

/mcp o /mcp/p/<pin>

https://ai-game.dev/mcp es el endpoint base: el servidor enruta a uno de tus editores conectados. https://ai-game.dev/mcp/p/<pin> está fijado a un proyecto y siempre llega al editor de ese proyecto, aunque haya varios abiertos. setup-mcp escribe la URL fijada. Más información en la guía de autenticación.

Tokens de acceso personal — para CI y scripts

Para CI o para un cliente que no puede abrir un navegador, crea un token de acceso personal en tu página de tokens de acceso y envíalo como token bearer.

Cómo es una petición

Cada petición es un mensaje JSON-RPC 2.0 sobre Streamable HTTP. Una respuesta larga o progresiva se transmite como Server-Sent Events, así que envía ambos tipos de contenido en Accept. Este curl lista las herramientas de tu editor conectado con un token de acceso:

curl -N -X POST "https://ai-game.dev/mcp" \
  -H "Authorization: Bearer YOUR_PERSONAL_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'
AuthorizationBearer YOUR_PERSONAL_ACCESS_TOKENUn token de acceso personal o una clave de proyecto; los clientes OAuth envían su propio token
Acceptapplication/json, text/event-streamAmbos tipos: las respuestas pueden transmitirse en streaming
Content-Typeapplication/jsonEl cuerpo JSON-RPC
method"initialize" | "tools/list" | "tools/call" | …Métodos MCP estándar

Configuración para tu cliente

Elige tu cliente y copia su configuración. La primera pestaña inicia sesión con OAuth; la pestaña del token de acceso es para CI. Todo lo que hable MCP funciona: aquí aparecen 14 clientes.

Todas las URL de abajo son la base https://ai-game.dev/mcp. Para fijar un cliente a un solo proyecto, usa https://ai-game.dev/mcp/p/<pin>: setup-mcp escribe la URL fijada por ti.

14
Settings → Connectors → Add custom connector
Name: ai-game-dev
URL:  https://ai-game.dev/mcp
↗ Abrir Claude Desktop
Punto de conexión activo. /api/status informa el estado actual del punto de conexión.