Servidor MCP

Conecte o Claude Code, Cursor, Codex, VS Code e outros clientes MCP aos modelos de imagem e vídeo do SeedRouter com sua chave de API.

O SeedRouter oferece um servidor remoto de Model Context Protocol. Um agente de IA pode usá-lo para listar modelos de imagem e vídeo, ler seus esquemas de requisição e preços, enviar tarefas de geração e recuperar os resultados, sem que você precise escrever código de integração.

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

Transporte: Streamable HTTP, sem estado. O servidor aceita a versão 2026-07-28 do protocolo e as versões anteriores que começam com uma negociação initialize, até a 2024-11-05.
Autenticação: sua chave de API do SeedRouter como token Bearer, Authorization: Bearer YOUR_API_KEY. Crie uma na página de chaves de API; veja Autenticação.
Cobrança: a mesma da API HTTP. Cada chamada a submit_task é uma requisição ao endpoint de tarefas correspondente e é cobrada da mesma forma.

Clientes que só permitem entrar com OAuth, sem um campo para um cabeçalho personalizado, ainda não podem se conectar.

Conectar um cliente

A página de chaves de API tem um botão Conectar via MCP que insere uma das suas chaves na configuração de cada cliente abaixo.

Claude Code

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

Cursor

Adicione a ~/.cursor/mcp.json, ou a .cursor/mcp.json em um projeto:

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

Codex CLI

O Codex lê a chave de uma variável de ambiente:

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

O Codex armazena o nome da variável, não a chave. Inicie o Codex em um shell no qual SEEDROUTER_API_KEY esteja definida, por exemplo, exportando-a no perfil do seu shell.

VS Code

Adicione a .vscode/mcp.json:

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

Qualquer outro cliente que aceite servidores remotos Streamable HTTP com um cabeçalho Authorization personalizado é configurado da mesma forma.

Ferramentas

Ferramenta	O que faz	Desconta do seu saldo
`list_models`	Lista os IDs de modelo aceitos por `submit_task`, cada um com o link para sua documentação. `endpoint` opcional: `images` ou `videos`.	Não
`get_model_schema`	Retorna o JSON Schema do corpo da requisição de um modelo. Regras que o JSON Schema não consegue expressar, como requisitos condicionais e limites entre campos, são aplicadas pela API e descritas na página de documentação do modelo.	Não
`get_pricing`	Retorna os preços de tabela atuais de um modelo em USD, com base nas mesmas tarifas vigentes usadas na cobrança, incluindo as faixas de preço dos modelos.	Não
`submit_task`	Envia uma tarefa: `model` mais `input`, o corpo da requisição descrito por `get_model_schema`. Retorna um ID de tarefa.	Sim, em toda chamada que cria uma tarefa
`get_task`	Retorna o estado e o resultado de uma tarefa. O parâmetro opcional `wait_seconds` (0–50) aguarda no servidor enquanto a tarefa ainda está em execução.	Não
`get_balance`	Retorna o saldo restante, em USD, da conta à qual a chave pertence.	Não

submit_task não é idempotente. Repetir uma chamada cria uma segunda tarefa e desconta seu custo do saldo, então consulte get_task, get_balance ou seu histórico de tarefas antes de repetir uma chamada cujo resultado você não recebeu.

Fluxo típico

list_models com endpoint: "images".
get_model_schema para o modelo escolhido.
Opcionalmente, get_pricing para ver a tarifa primeiro.
submit_task com model e um input que corresponda ao esquema.
get_task com wait_seconds: 50, repetindo enquanto status for processing, e depois leia output. As tarefas do Seedance informam queued e running antes de succeeded.

A geração é assíncrona, exatamente como na API HTTP: submit_task retorna assim que a tarefa é aceita. wait_seconds evita que o agente precise fazer consultas em um loop, mas um vídeo longo ainda pode exigir várias chamadas a get_task. Se uma consulta de estado falhar por um motivo temporário durante a espera, como um limite de requisições ou um erro do servidor, get_task retorna o último resultado processing em vez do erro; chame-o novamente.

Regras mantidas da API HTTP

Imagens, vídeos e áudios de referência devem ser URLs http(s) públicas. Entradas em Base64 são rejeitadas.
Quando a API HTTP responde, o corpo da resposta é retornado sem alterações como resultado da ferramenta, com os mesmos códigos de erro. Erros que ocorrem antes de uma requisição chegar à API, como um modelo desconhecido ou argumentos de ferramenta inválidos, retornam como uma mensagem de erro simples. Uma chave rejeitada no próprio endpoint MCP retorna HTTP 401.
Tarefas que falham não são cobradas.
Por padrão, uma conta pode ter até 50 tarefas de imagem e vídeo em execução ao mesmo tempo. Novos envios retornam HTTP 429 com o código 30002 até que tarefas em execução terminem; veja Usar o SeedRouter com agentes de IA.
Os IDs de modelo e os parâmetros são os da documentação de cada modelo. Um modelo aparece em list_models assim que estiver disponível na API.
Modelos de texto não são oferecidos via MCP. Faça chamadas a eles nos endpoints de texto, ou execute um agente de programação com eles conforme descrito em Agentes de programação no SeedRouter.

On this page