O servidor MCP do ToRun
Última atualização: 11 nov. 2026
O que é
O servidor MCP do ToRun permite que um agente de programação utilize o ToRun enquanto trabalha no seu projeto. Um agente que suporte servidores MCP remotos, como o Claude Code, o Cursor ou o opencode, pode criar imagens, voz, música e vídeo, editar imagens, transcrever áudio, executar pesquisas profundas e os modelos de workflow do ToRun, e publicar uma página HTML ou um jogo de browser como ligação, sem que saia do seu editor. O que o agente cria é pago pela sua conta ToRun aos mesmos preços que na aplicação e é guardado na sua conta ToRun como tudo o que cria na aplicação.
Endereço e início de sessão
| Endereço do servidor | https://mcp.torun.ai/mcp |
| Transporte | HTTP (servidor MCP remoto) |
| Início de sessão | Authorization: Bearer <your developer key> |
Uma chave de programador começa por trn_live_. Cria-a na página Programadores da sua conta ToRun: consulte Chaves de programador. Configuração para cada ferramenta:
Ferramentas
| Ferramenta | O que faz | Paga |
|---|---|---|
image_generate |
Cria imagens a partir de um prompt: sprites, ícones, fundos, ilustrações. Devolve as imagens, ou um id de tarefa quando demoram mais do que o agente escolheu esperar. | Sim |
image_edit |
Altera uma imagem a partir de uma instrução escrita: um novo fundo, outra cor, um objeto adicionado ou removido, outro estilo. A imagem é uma que o agente criou com o ToRun ou uma ligação para um ficheiro PNG, JPEG ou WebP até 20 MB; uma imagem indicada por ligação é primeiro guardada na sua biblioteca ToRun. Devolve as imagens ou um id de tarefa, como image_generate. |
Sim |
tts_generate |
Converte texto em voz e devolve o ficheiro de áudio e a duração da reprodução, medida a partir do ficheiro. | Sim |
stt_transcribe |
Converte em texto a fala de um ficheiro de áudio ou vídeo, com segmentos temporizados para legendas quando o agente os pede. Aceita ficheiros mp3, m4a, wav, webm, ogg, opus, flac, aac e mp4 até 25 MB. | Sim |
music_generate |
Compõe uma faixa, com ou sem voz, e devolve um id de tarefa. | Sim |
video_generate |
Cria um clipe curto a partir de um prompt e devolve um id de tarefa. | Sim |
job_status |
Informa sobre uma tarefa de imagem, música ou vídeo e devolve o ficheiro quando está pronto. | Gratuita |
deep_research_start |
Inicia uma pesquisa profunda sobre uma pergunta: pesquisa na web em muitas fontes e escreve um relatório com as fontes citadas. Devolve um id de tarefa. | Sim |
deep_research_status |
Informa sobre uma pesquisa profunda e devolve o relatório quando está pronto. | Gratuita |
workflow_template_search |
Encontra os modelos de workflow do ToRun, fluxos de vários passos prontos a usar, e mostra o que cada um produz, quanto costuma custar e as entradas que recebe. | Gratuita |
workflow_run |
Executa um modelo de workflow com as entradas que o agente lhe dá e devolve um id de tarefa. | Sim |
workflow_run_status |
Informa sobre uma execução de workflow e os Runs que custou até agora, e devolve os resultados quando estão prontos. | Gratuita |
canvas_publish |
Publica como ligação uma página HTML de um único ficheiro ou um jogo de browser. | Gratuita |
account_balance |
Mostra a quota do plano e a carteira restantes, bem como o limite mensal e os gastos desta chave. | Gratuita |
Uma ligação para um ficheiro devolvida por uma ferramenta transfere-se sem iniciar sessão, por isso o agente pode guardar o ficheiro no seu projeto. Mantenha a ligação completa, incluindo a parte depois do ponto de interrogação.
Uma página publicada não fica listada: qualquer pessoa com a ligação pode abri-la, mas não aparece no Explorar do ToRun e os motores de pesquisa não a indexam.
Tarefas longas
A música, o vídeo, as pesquisas profundas e as execuções de workflow demoram mais do que uma chamada. A ferramenta devolve um id de tarefa, e o agente pergunta de novo até o resultado estar pronto: job_status para imagens, música e vídeo, deep_research_status para um relatório de pesquisa e workflow_run_status para uma execução de workflow. Uma imagem que não esteja pronta dentro do tempo de espera escolhido pelo agente também regressa como um id de tarefa.
Uma pesquisa demora entre 1 e 10 minutos e continua mesmo que a conversa com o seu agente termine; o relatório aparece também como uma conversa própria na sua lista de chats do ToRun. Uma execução de workflow demora de um minuto a dezenas de minutos, e a execução e os seus ficheiros aparecem na sua conta ToRun. Um relatório longo ou um conjunto longo de resultados chega por partes, e o agente pede o resto.
Como as chamadas são pagas
- Cada chamada paga é cobrada em Runs aos mesmos preços que na aplicação.
- É paga primeiro pela quota do seu plano e depois pela sua carteira, se o tiver permitido na chave.
- A quota gratuita nunca paga chamadas à API.
- Uma execução de workflow é cobrada passo a passo enquanto decorre.
- Cada cobrança aparece na sua página de faturação, sob a chave que a fez.
Uma chamada acima do limiar da chave pergunta primeiro
Cada chave tem um limiar. Quando uma única chamada custaria mais do que isso, a ferramenta ainda não a executa. Numa execução de workflow, é a estimativa da execução que é comparada.
- Se a sua ferramenta conseguir mostrar um formulário quando um servidor MCP faz uma pergunta (MCP elicitation), o ToRun pergunta-lhe aí: o formulário mostra o preço e pergunta se deve continuar. A chamada é executada se disser que sim; se recusar, nada é executado.
- Caso contrário, a ferramenta responde com o preço, o seu agente mostra-lho e a chamada só é executada quando o agente a repete depois de concordar.
Perguntar não tem custos.
Limites
Cada chave tem um limite de gastos mensal e um diário, e um limite de chamadas por minuto. Cada conta tem também um limite diário de páginas publicadas. Define o limite mensal e o limiar de uma chave quando a cria; os valores predefinidos estão em torun.ai/developers. Para os alterar, crie uma nova chave com as definições que pretende e revogue a antiga.
Quando uma chamada é recusada
| O que é dito ao agente | O que fazer |
|---|---|
| A chamada precisa de uma chave de programador | Verifique se TORUN_API_KEY contém a chave completa e se a chave não foi revogada. |
| A quota do plano esgotou-se e a chave não pode gastar da carteira | Aguarde que a quota seja renovada, ou crie uma chave que possa gastar da carteira. |
| As chaves de programador só gastam a quota de um plano pago ou a carteira | Carregue saldo ou subscreva. |
| A chave atingiu o seu limite de gastos mensal ou diário | Aguarde pelo dia ou mês seguinte, ou crie uma chave com um limite mais alto. |
| A chave fez demasiadas chamadas num minuto | Aguarde um momento e tente de novo. |
| A chave não tem o âmbito de que uma ferramenta precisa | Os âmbitos de uma chave não podem ser alterados. Crie uma nova chave: uma chave nova tem todos os âmbitos. |
| O ficheiro tem de ser indicado como um id da biblioteca ToRun ou como uma ligação https, não ambos | Indique exatamente um dos dois. |
| Não existe esse ficheiro na biblioteca ToRun da conta | Utilize um ficheiro desta conta. Uma ligação ToRun para o ficheiro de outra conta é recusada da mesma forma. |
| O ficheiro é demasiado grande, não está num formato que a ferramenta aceite ou não pôde ser transferido | Imagens para image_edit: PNG, JPEG ou WebP, até 20 MB. Ficheiros para stt_transcribe: mp3, m4a, wav, webm, ogg, opus, flac, aac ou mp4, até 25 MB. Uma ligação tem de se transferir sem iniciar sessão. |