Servidores MCP no agente de IA
Os servidores MCP (Model Context Protocol) fornecem ferramentas adicionais ao agente. O agente suporta dois tipos:
| Tipo | Onde ele é executado | Onde está configurado |
|---|---|---|
| Hospedado | Fora da sua máquina; CHAMPREPconecta-se a ela via HTTPS | Sua CHAMPREP AIconta, compartilhada com os aplicativos da web, de desktop e móveis |
| Local | Um programa iniciado em seu computador, que se comunica via MCP por meio da entrada e saída padrão | Um 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.
A janela /mcp
Seção intitulada “A janela /mcp”/mcpA janela lista todos os servidores hospedados e locais com seu status e ferramentas. Selecione um servidor com as setas do teclado e pressione:
| Chave | Ação |
|---|---|
Enter | Exiba as ações para o servidor. |
e | Ative ou desative o servidor. |
r | Atualizar: reconecte-se e recarregue suas ferramentas. |
a | Reautenticar: substitua a credencial. |
t | Liste suas ferramentas. |
x | Remova o servidor. |
n | Adicione 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.
Servidores hospedados
Seção intitulada “Servidores hospedados”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
Seção intitulada “Servidores locais”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.
Servidores de projeto e confiança
Seção intitulada “Servidores de projeto e confiança”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.
Aprovação de chamadas à ferramenta MCP
Seção intitulada “Aprovação de chamadas à ferramenta MCP”- 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 dogithubservidor. 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.