Pular para o conteúdo
Documentation

Servidores MCP no agente de IA

Os servidores MCP (Model Context Protocol) fornecem ferramentas adicionais ao agente. O agente suporta dois tipos:

TipoOnde ele é executadoOnde está configurado
HospedadoFora da sua máquina; CHAMPREPconecta-se a ela via HTTPSSua CHAMPREP AIconta, compartilhada com os aplicativos da web, de desktop e móveis
LocalUm programa iniciado em seu computador, que se comunica via MCP por meio da entrada e saída padrãoUm mcp.json arquivo para você ou para o projeto

Esta página trata da conexão de servidores ao agente. Para utilizar o próprioCHAMPREP CHAMPREP a partir de outro cliente MCP, consulte o CHAMPREP Servidor MCP.

/mcp

A janela lista todos os servidores hospedados e locais com seu status e ferramentas. Selecione um servidor com as setas do teclado e pressione:

ChaveAção
EnterExiba as ações para o servidor.
eAtive ou desative o servidor.
rAtualizar: reconecte-se e recarregue suas ferramentas.
aReautenticar: substitua a credencial.
tListe suas ferramentas.
xRemova o servidor.
nAdicione um servidor.

Os atalhos também funcionam sem a janela, por exemplo /mcp list, /mcp enable NAME, /mcp disable NAME, /mcp refresh NAME, e, para servidores locais, /mcp restart NAME e /mcp remove NAME.

Os servidores hospedados pertencem à sua contaCHAMPREP AI; portanto, um servidor que você adicionar no terminal também estará disponível na web, e vice-versa. Suas ferramentas são executadas no CHAMPREP, e não na sua máquina.

Para adicionar um, pressione n em /mcp, escolha um servidor hospedado e insira sua URL e credencial, como um token de portador. A credencial é inserida em um campo mascarado , enviada uma única vez para a sua CHAMPREP AIconta e nunca é exibida, salva localmente, registrada em logs ou fornecida ao modelo. Utilize a para substituir uma credencial vencida.

A remoção de um servidor hospedado o exclui de sua conta em todas as plataformas. Se uma ação relacionada a um servidor hospedado não estiver disponível no CLIem seu ambiente, o agente informará isso; utilize suas configuraçõesCHAMPREP AI na web como alternativa.

Servidores locais são programas que o agente inicia em sua máquina. Adicione um com n em /mcp e selecione:

  • o nome do servidor e o comando com seus argumentos;
  • exclusivamente para o senhor (seu usuário mcp.json) ou para este projeto (.champrep/mcp.json, que o senhor pode confirmar);
  • Opcionalmente, uma variável de ambiente que contém uma credencial. Seu valor é mascarado, armazenado apenas no seu perfil de usuário mcp.json, e nunca são gravados em um arquivo de projeto , histórico, logs ou no contexto do modelo.

Você também pode editar os arquivos diretamente. Eles utilizam o formato comum do cliente MCP. Mantenha as credenciais no seu arquivo de usuário, nunca em um arquivo de projeto que você submeta:

{
"mcpServers": {
"github": {
"command": "github-mcp-server",
"args": ["stdio"],
"env": { "GITHUB_TOKEN": "YOUR_TOKEN" }
}
}
}

Campos opcionais por servidor: disabled, include_tools, exclude_tools, startup_timeout_sec (padrão 30), tool_timeout_sec (padrão 120, máximo 600) e priority. Apenas servidores locais (stdio) devem constar nesses arquivos; adicione servidores HTTP como servidores hospedados.

Os servidores locais nunca recebem suas CHAMPREPcredenciais nem qualquer CHAMPREP_* variável de ambiente.

Executar champrep ai paths para localizar seu usuário mcp.json. Os servidores MCP locais são um recurso do plano; consulte Planos e limites.

Um projeto .champrep/mcp.json executa comandos em sua máquina; portanto, seus servidores só são iniciados depois que o senhor confia no projeto .champrep/ configuração. Se o arquivo for alterado, será solicitado novamente. Consulte Confiança do repositório.

  • Ferramentas do servidor local são tratados como comandos: cada chamada solicita sua autorização, exibindo o servidor e os argumentos, a menos que uma regra de permissão abranja essa situação. Por exemplo, local_mcp__github__* permite que todas as ferramentas do github servidor. As regras de negação funcionam da mesma maneira.
  • Ferramentas de servidor hospedado Siga a configuração de aprovação do servidor em sua CHAMPREP AI conta. Quando uma chamada precisa de aprovação, o agente exibe um cartão de aprovação; nada é aprovado automaticamente.

O agente pode oferecer, no máximo, 64 ferramentas locais por rodada. Quando os servidores locais fornecem mais, os de menorpriority Os servidores são filtrados primeiro e o agente informa a você. Use include_tools ou exclude_tools para manter as ferramentas de que o senhor precisa.