Para conectar ferramentas ao Claude Code por MCP, use a configuração publicada pelo fornecedor, registre o servidor e conclua a autenticação exigida. Depois, verifique o estado da conexão e uma operação autorizada. Cadastrar o endereço é diferente de comprovar que o serviço responde e oferece a informação necessária ao projeto.
Este guia trata do Claude Code. Um conector adicionado ao aplicativo, um servidor local no Desktop e uma configuração dentro do projeto podem ter percursos diferentes. Identifique o ambiente antes de copiar comandos.
Defina a operação antes de cadastrar o servidor
Escreva qual informação a tarefa exige e por que ela está em um serviço externo. “Consultar o estado de um item identificado” delimita melhor o trabalho do que “conectar a plataforma”.
Separe operações de leitura e de alteração. Para cada uma, registre quem pode autorizar o uso e qual resultado permite reconhecer que a ação terminou.
Essa definição ajuda a escolher uma configuração pertinente. Se o servidor não oferece a operação necessária, uma conexão ativa não resolve a lacuna da tarefa.
Use a documentação do próprio fornecedor para obter o endereço e os requisitos. Não deduza uma URL a partir do nome comercial do produto ou de um exemplo encontrado em outra ferramenta.
Cadastre um servidor HTTP com os valores oficiais
O guia de MCP do Claude Code recomenda HTTP para servidores remotos e documenta a estrutura de cadastro abaixo:
claude mcp add --transport http NOME URL_OFICIAL
Substitua os dois parâmetros pelo identificador escolhido e pelo endereço publicado pelo serviço. A linha descreve a estrutura do comando; o endpoint precisa vir da configuração oficial que você vai utilizar.
Antes de executar, confirme em qual projeto está trabalhando e qual escopo pretende manter. Isso permite explicar posteriormente onde a conexão foi registrada e por que ela pertence àquela atividade.
Guarde uma referência à documentação utilizada. Se o fornecedor alterar o percurso de autenticação ou o endereço, a equipe consegue localizar a origem da configuração.
Conclua a autenticação e examine o estado
Dentro da sessão, /mcp permite examinar as conexões e realizar OAuth pelo navegador quando o serviço exigir. Para listar o estado pelo terminal, o guia também oferece:
claude mcp list
A configuração salva pode permanecer pendente de autorização. Trate cadastro, autenticação e disponibilidade como conferências diferentes.
Se uma etapa não terminar, registre o estado observado. Evite apresentar o serviço como conectado apenas porque o comando de adição aceitou os parâmetros.
Confira a conta autorizada e o contexto do serviço. Quando existem espaços pessoais e de equipe, essa identificação faz parte da avaliação da primeira ferramenta disponível.
Revise o escopo antes de compartilhar
O padrão documentado é local para o projeto. A opção --scope project escreve a configuração em .mcp.json, que deve ser revisada antes de compartilhar; credenciais não devem ir para o Git.
A decisão de compartilhar uma configuração precisa corresponder ao uso da equipe. Um endereço disponível no repositório não demonstra que cada pessoa já possui o acesso necessário.
Os controles de permissão do Code pertencem ao ambiente. Ajuste o trabalho autorizado ao impacto das operações, em vez de considerar que uma instrução escrita concede ou bloqueia acesso por si só.
Ao revisar a configuração, separe o que é informação compartilhável do que pertence à sessão de uma pessoa. Essa distinção facilita a manutenção sem transformar o repositório em armazenamento de segredos.
Faça uma primeira consulta com origem reconhecível
Escolha uma operação de consulta que a documentação do serviço confirme e uma informação que você consegue comparar com a origem. O primeiro objetivo é reconhecer a ferramenta, os parâmetros e a resposta.
Um pedido próprio pode ser:
Use a ferramenta de consulta autorizada para responder à pergunta definida para esta tarefa. Informe a origem utilizada e registre ausências ou falhas. Não faça alterações no serviço. Ao final, separe o resultado da consulta de qualquer recomendação de próximo passo.
O pedido não inventa um nome de ferramenta nem dispensa a leitura de suas entradas. Adapte-o somente após identificar as operações realmente disponíveis.
Compare o resultado com o serviço. Verifique se um item ausente foi tratado como ausência e se uma falha de acesso ficou visível. Uma resposta bem redigida não substitui essa comparação.
Registre o que ficou pronto
A entrega de configuração deve permitir responder qual servidor foi cadastrado, em que escopo, com qual conta autorizada e qual consulta foi verificada. Mantenha separadas as ações que continuam pendentes.
Se houver necessidade de alteração em um serviço, trate isso como uma próxima tarefa com impacto e autorização próprios. A primeira consulta não é uma aprovação ampla de escrita.
Quando o objetivo for atendimento, avalie o Claude na Nextags no contexto do agente da operação. Uma conexão usada no Code não é incorporada automaticamente ao AI Hub.
Fontes e referências
Regras e recursos dos canais podem mudar. Confira as condições atuais nas fontes oficiais antes de colocar sua operação no ar.
Conteúdo de Angelo Sebastião Silva Goncalves. Preparado com apoio de IA. Consulte as fontes e os critérios editoriais. Conheça nossos critérios editoriais e como solicitar uma correção.
