Servidor MCP

Conecta Claude Code, Cursor, Codex, VS Code y otros clientes MCP a los modelos de imagen y vídeo de SeedRouter con tu clave de API.

SeedRouter ofrece un servidor remoto de Model Context Protocol. Un agente de IA puede usarlo para listar modelos de imagen y vídeo, leer sus esquemas de solicitud y precios, enviar tareas de generación y recuperar los resultados, sin que tengas que escribir código de integración.

https://api.seedrouter.ai/v1/mcp

Transporte: Streamable HTTP, sin estado. El servidor admite la versión del protocolo 2026-07-28 y las versiones anteriores que empiezan con un intercambio initialize, hasta la 2024-11-05.
Autenticación: tu clave de API de SeedRouter como token Bearer, Authorization: Bearer YOUR_API_KEY. Crea una en la página de claves de API; consulta Autenticación.
Facturación: la misma que en la API HTTP. Cada llamada a submit_task es una solicitud al endpoint de tareas correspondiente y se cobra de la misma forma.

Los clientes que solo pueden iniciar sesión con OAuth y no tienen un campo para una cabecera personalizada aún no pueden conectarse.

Conectar un cliente

La página de claves de API tiene un botón Conectar mediante MCP que introduce una de tus claves en la configuración de cada uno de los siguientes clientes.

Claude Code

claude mcp add --transport http seedrouter https://api.seedrouter.ai/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Añade lo siguiente a ~/.cursor/mcp.json o a .cursor/mcp.json en un proyecto:

{
  "mcpServers": {
    "seedrouter": {
      "url": "https://api.seedrouter.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex CLI

Codex lee la clave de una variable de entorno:

export SEEDROUTER_API_KEY=YOUR_API_KEY
codex mcp add seedrouter --url https://api.seedrouter.ai/v1/mcp \
  --bearer-token-env-var SEEDROUTER_API_KEY

Codex guarda el nombre de la variable, no la clave. Inicia Codex desde un shell en el que esté definida SEEDROUTER_API_KEY, por ejemplo, exportándola en el perfil de tu shell.

VS Code

Añade lo siguiente a .vscode/mcp.json:

{
  "servers": {
    "seedrouter": {
      "type": "http",
      "url": "https://api.seedrouter.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cualquier otro cliente que admita servidores remotos Streamable HTTP con una cabecera Authorization personalizada se configura de la misma manera.

Herramientas

Herramienta	Qué hace	Descuenta de tu saldo
`list_models`	Lista los ID de modelo que acepta `submit_task`, cada uno con el enlace a su documentación. `endpoint` opcional: `images` o `videos`.	No
`get_model_schema`	Devuelve el JSON Schema del cuerpo de la solicitud de un modelo. Las reglas que JSON Schema no puede expresar, como los requisitos condicionales y los límites entre campos, las aplica la API y se describen en la página de documentación del modelo.	No
`get_pricing`	Devuelve los precios de lista actuales de un modelo en USD, a partir de las mismas tarifas vigentes que usa la facturación, incluidos los niveles de precios de los modelos.	No
`submit_task`	Envía una tarea: `model` más `input`, el cuerpo de la solicitud descrito por `get_model_schema`. Devuelve un ID de tarea.	Sí, por cada llamada que crea una tarea
`get_task`	Devuelve el estado y el resultado de una tarea. El parámetro opcional `wait_seconds` (0–50) espera en el servidor mientras la tarea sigue ejecutándose.	No
`get_balance`	Devuelve el saldo restante, en USD, de la cuenta a la que pertenece la clave.	No

submit_task no es idempotente. Reintentar una llamada crea una segunda tarea y descuenta su coste del saldo, así que consulta get_task, get_balance o tu historial de tareas antes de reintentar una llamada cuyo resultado no hayas recibido.

Flujo habitual

list_models con endpoint: "images".
get_model_schema para el modelo que hayas elegido.
Opcionalmente, get_pricing para ver primero la tarifa.
submit_task con model y un input que coincida con el esquema.
get_task con wait_seconds: 50, repitiendo mientras status sea processing, y después lee output. Las tareas de Seedance muestran queued y running antes de succeeded.

La generación es asíncrona, igual que en la API HTTP: submit_task devuelve una respuesta en cuanto se acepta la tarea. wait_seconds evita que el agente tenga que sondear en un bucle, pero un vídeo largo puede seguir necesitando varias llamadas a get_task. Si una consulta de estado falla por un motivo temporal durante la espera, como un límite de solicitudes o un error del servidor, get_task devuelve el último resultado processing en lugar del error; vuelve a llamarlo.

Reglas que se mantienen de la API HTTP

Las imágenes, vídeos y audios de referencia deben ser URL http(s) públicas. Se rechazan las entradas en Base64.
Cuando responde la API HTTP, el cuerpo de su respuesta se devuelve sin cambios como resultado de la herramienta, con los mismos códigos de error. Los errores que se producen antes de que una solicitud llegue a ella, como un modelo desconocido o argumentos de herramienta no válidos, se devuelven como un mensaje de error simple. Una clave rechazada en el propio endpoint MCP devuelve HTTP 401.
Las tareas fallidas no se cobran.
Por defecto, una cuenta puede tener hasta 50 tareas de imagen y vídeo en ejecución al mismo tiempo. Los envíos adicionales devuelven HTTP 429 con el código 30002 hasta que terminen tareas en ejecución; consulta Usar SeedRouter desde agentes de IA.
Los ID de modelo y los parámetros son los de la documentación de cada modelo. Un modelo aparece en list_models cuando está disponible en la API.
Los modelos de texto no se ofrecen a través de MCP. Llámalos en los endpoints de texto o ejecuta un agente de programación con ellos como se describe en Agentes de programación en SeedRouter.

On this page