# MCP no Claude Code: como conectar ferramentas ao projeto Conecte um servidor MCP ao Claude Code com endereço oficial, autenticação, revisão de escopo e uma primeira consulta que possa ser conferida. Autoria: Angelo Sebastião Silva Goncalves Publicado: 2026-11-08T19:00:00.000Z Revisado: 2026-10-27T22:11:48.783Z URL canônica: https://nextags.com.br/blog/mcp-no-claude-code-como-conectar-ferramentas-ao-projeto/ 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](https://code.claude.com/docs/en/mcp) recomenda HTTP para servidores remotos e documenta a estrutura de cadastro abaixo: ```text 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: ```text 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](https://code.claude.com/docs/en/permissions) 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: ```text 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](https://nextags.com.br/integracoes/claude/) no contexto do agente da operação. Uma conexão usada no Code não é incorporada automaticamente ao AI Hub. ## Fontes - [Documentação Claude Code: conexões MCP](https://code.claude.com/docs/en/mcp) - [Controles de permissão no Code](https://code.claude.com/docs/en/permissions)