Documentação

Coroid como servidor MCP

Gerencie o Coroid a partir do seu próprio assistente ou editor por meio de um endpoint MCP remoto.

Coroid disponibiliza um servidor remoto Model Context Protocol , para que um cliente agente externo possa gerenciar tarefas no Coroid por meio do mesmo registro de ferramentas governado utilizado pelo assistente de chat.

Configure em Configurações → Automação → Coroid MCP server, abrangendo Visão geral, Configuração do cliente, Tokens de acesso, Aprovações e Políticas de automação.

O endpoint

O servidor MCP é hospedado pelo API gateway:

https://api.coroid.ai/mcp
AmbienteEndpoint
Produçãohttps://api.coroid.ai/mcp
Staginghttps://staging-api.coroid.ai/mcp
Desenvolvimentohttp://localhost:3000/mcp

O transporte utilizado é HTTP streamable sem estado. A autenticação ocorre via OAuth ou token de acesso pessoal.

O que ele deliberadamente não expõe

O registro de ferramentas é governado, e as exclusões são intencionais. Ele não fornece:

  • um shell
  • Acesso ao Git
  • o sistema de arquivos
  • acesso bruto ao banco de dados
  • HTTP interno arbitrário
  • ferramentas de administração MCP de saída próprias do Coroid

Você ganha a capacidade de gerenciar tarefas — criar e inspecionar tarefas, planos e projetos — não um ambiente de execução remoto. Um cliente MCP não pode usar o Coroid para executar comandos arbitrários.

Tokens de acesso

Os tokens são criados e gerenciados em Tokens de acesso. Assim como qualquer outra credencial, eles são exibidos uma única vez e nunca mais retornados posteriormente.

Emissão de um token por cliente, em vez de compartilhar um só. Dessa forma, revogar o acesso de um único cliente é uma ação isolada, sem afetar todos os demais.

Aprovações e políticas de automação

Aprovações constituem uma fila de ações aguardando aprovação humana. Políticas de automação definem o que deve entrar nessa fila.

Esse é o controle essencial. Um cliente externo agindo em seu nome deve poder realizar tarefas rotineiras livremente e apenas ações relevantes com autorização humana. Defina as políticas antes de fornecer um token a qualquer elemento que execute de forma autônoma.

Para que ele é útil

Gerenciar o Coroid a partir do lugar onde você já trabalha — um editor, assistente ou ferramenta interna — sem precisar acessar o portal. Criar uma tarefa a partir do seu terminal ou pedir ao assistente para verificar o que está bloqueado torna-se uma ação local.