O que é um servidor MCP?

Um host de tools para um cliente de IA. O MCP do narrador está em https://api.narrador.io/mcp como io.narrador/narrador.

Como adiciono no Claude Desktop, Cursor ou VS Code?

Se o cliente suporta MCP OAuth remoto, adicione https://api.narrador.io/mcp e entre. Senão, use Authorization Bearer com uma key nrd_files_ ou nrd_x_. Há amostras em https://api.narrador.io/docs.

Não. A API usa os mesmos créditos do app, pelo mesmo preço.

MCP e REST API

API de texto para fala e servidor MCP para agentes de IA

Dê aos seus agentes uma API de texto para fala e um servidor MCP. Conecte em https://api.narrador.io/mcp com OAuth ou uma API key, ou use a referência REST em https://api.narrador.io/docs.

Documentos com o narrador files
create_files_job ou POST /v1/files/generate. Sem voiceId, a voz segue o idioma.
Posts do X com o narrador X
generate_x_audio devolve áudio, não vídeo. A exportação de vídeo fica no app.
Os mesmos créditos, MCP ou REST
Conecte com OAuth no Cursor, Claude Desktop ou VS Code, ou use uma key nrd_files_ ou nrd_x_.

Abra os docs da API

Cursor, Claude Desktop e VS Code

Configuração MCP remota — as mesmas amostras da docs da API. Clientes com OAuth MCP remoto só precisam da URL, incluindo Cursor, Claude Desktop e VS Code. As API keys continuam sendo a alternativa: nrd_files_ para ferramentas do narrador files, nrd_x_ para o narrador X.

Adicione em .cursor/mcp.json do projeto, ou em ~/.cursor/mcp.json para todos.

OAuth

Recomendado quando o cliente suporta MCP OAuth remoto. Só a URL — depois entre. Scopes: narrador:files, narrador:x.

{
  "mcpServers": {
    "narrador": {
      "url": "https://api.narrador.io/mcp"
    }
  }
}

API key

Alternativa para clientes e scripts. A mesma URL mais Authorization Bearer ou x-api-key.

{
  "mcpServers": {
    "narrador": {
      "url": "https://api.narrador.io/mcp",
      "headers": {
        "Authorization": "Bearer nrd_files_YOUR_SECRET_KEY"
      }
    }
  }
}

Limites

Rate limit: 60 requisições por 60 segundos por API key. Excesso retorna HTTP 429.
Tamanho do arquivo: Máximo de 50 MB por upload de arquivo e por download por URL nas rotas do narrador files.
Texto simples: Até 500.000 caracteres no campo text em POST /v1/files/generate e POST /v1/files/jobs.

Perguntas frequentes

O que é um servidor MCP?: Um host de tools para um cliente de IA. O MCP do narrador está em https://api.narrador.io/mcp como io.narrador/narrador.
Como adiciono no Claude Desktop, Cursor ou VS Code?: Se o cliente suporta MCP OAuth remoto, adicione https://api.narrador.io/mcp e entre. Senão, use Authorization Bearer com uma key nrd_files_ ou nrd_x_. Há amostras em https://api.narrador.io/docs.
A API custa extra?: Não. A API usa os mesmos créditos do app, pelo mesmo preço.