Passar para o conteúdo principal

Como configurar o MCP no Claude, ChatGPT, Codex e Copilot

Passo a passo para conectar cada assistente de IA à sua área de trabalho da Coodesh, com os comandos de cada cliente e o que fazer quando a conexão falha.

Este artigo traz o passo a passo de cada assistente para conectar a sua área de trabalho da Coodesh via MCP (Model Context Protocol). Se você ainda não sabe o que é o MCP e quais permissões o assistente recebe, comece por Como conectar seu assistente de IA (MCP).

Antes de começar

O MCP está disponível para contas de empresa. Você precisa estar logado na Coodesh e fazer parte de pelo menos uma área de trabalho.

Estes são os únicos dados que qualquer assistente vai pedir:

  • Endereço do servidor: https://coodesh.com/mcp

  • Tipo de conexão: servidor remoto, transporte Streamable HTTP (alguns clientes chamam de HTTP). Não escolha SSE nem stdio.

  • Autenticação: OAuth, feita no navegador.

Não existe chave de API para colar. Se o assistente pedir um token ou um cabeçalho de autenticação, deixe em branco: a autorização acontece no navegador, na tela da Coodesh.

Claude Code (terminal)

No terminal, adicione o servidor:

claude mcp add --transport http --scope user coodesh https://coodesh.com/mcp

O --scope user deixa a conexão disponível em todos os seus projetos. Sem ele, o servidor vale apenas para a pasta em que você estava.

Em seguida:

  1. Abra o Claude Code e digite /mcp.

  2. Selecione coodesh e depois Authenticate. O navegador abre na tela de autorização da Coodesh.

  3. Faça login, escolha as áreas de trabalho e clique em Autorizar.

  4. Para conferir, rode claude mcp list. O servidor deve aparecer como Connected.

Claude Desktop e claude.ai

Planos Free, Pro e Max:

  1. Vá em Configurações > Customizar > Conectores.

  2. Clique em Adicionar conector personalizado.

  3. Informe a URL https://coodesh.com/mcp e clique em Adicionar. Deixe os campos de OAuth e de cabeçalhos vazios.

  4. Clique em Conectar e conclua a autorização no navegador.

Planos Team e Enterprise: apenas o proprietário da organização adiciona o conector, em Configurações da organização > Conectores > Adicionar > Personalizado (se o Claude perguntar o tipo, escolha Web). Depois disso, cada pessoa do time vai em Customizar > Conectores e clica em Conectar para autorizar com a própria conta Coodesh.

Dentro da conversa, use o botão + para ligar ou desligar o conector.

ChatGPT (aplicativo)

  1. Abra Configurações > Servidores MCP e clique em Adicionar servidor.

  2. Dê o nome Coodesh, escolha Streamable HTTP e informe a URL https://coodesh.com/mcp.

  3. Salve e clique em Reiniciar.

  4. Na lista de servidores, clique em Autenticar e conclua a autorização no navegador.

  5. Para conferir, digite /mcp no campo de mensagem: o servidor deve aparecer entre os conectados.

Codex (linha de comando)

Abra o arquivo ~/.codex/config.toml e adicione:

[mcp_servers.coodesh]
url = "https://coodesh.com/mcp"

Não preencha token nem cabeçalhos: o Codex já usa OAuth por padrão para servidores remotos. Em seguida, rode codex mcp login coodesh e conclua a autorização no navegador. Para conferir, rode codex mcp list.

GitHub Copilot (VS Code)

Pelo assistente de configuração:

  1. Abra a paleta de comandos (Ctrl+Shift+P ou Cmd+Shift+P) e execute MCP: Add Server.

  2. Escolha HTTP, informe a URL https://coodesh.com/mcp e o nome coodesh.

  3. Escolha onde salvar: o perfil do usuário, que vale para todos os projetos, ou apenas o projeto atual, em .vscode/mcp.json.

Ou editando o arquivo diretamente:

{
  "servers": {
    "coodesh": {
      "type": "http",
      "url": "https://coodesh.com/mcp"
    }
  }
}

Depois de salvar, clique em Start e em Auth, nos atalhos que aparecem logo acima da configuração do servidor, e conclua a autorização no navegador. No Copilot Chat, mude para o modo Agent e clique no ícone de ferramentas para ver o que a Coodesh disponibilizou.

No Visual Studio, no JetBrains e no Xcode a configuração é a mesma: um servidor remoto do tipo HTTP apontando para a mesma URL.

Microsoft 365 Copilot

O Microsoft 365 Copilot, o assistente que vem com o Office e o Teams, não aceita um servidor MCP direto na conversa. A conexão é feita uma vez no Copilot Studio, por quem administra, e vira um agente publicado para o time. É preciso ter licença do Copilot Studio e permissão para criar agentes.

  1. Abra o Copilot Studio e escolha, ou crie, o agente que vai usar os dados da Coodesh.

  2. Vá em Ferramentas (Tools) e clique em Adicionar uma ferramenta > Nova ferramenta > Model Context Protocol.

  3. Informe o nome do servidor (Coodesh), uma descrição curta do que ele faz e a URL https://coodesh.com/mcp. A descrição importa: é por ela que o agente decide quando consultar a Coodesh.

  4. Em autenticação, escolha OAuth 2.0 e, no tipo, Descoberta dinâmica (Dynamic discovery). Não preencha ID nem segredo de cliente: o nosso servidor registra o cliente sozinho. Clique em Criar.

  5. Na tela Adicionar ferramenta, clique em Criar nova conexão, conclua a autorização no navegador e depois em Adicionar ao agente.

  6. Publique o agente. Em Canais, abra Teams e Microsoft 365 Copilot, deixe marcado Disponibilizar o agente no Microsoft 365 Copilot e clique em Adicionar canal.

  7. Em Opções de disponibilidade, escolha entre mostrar o agente para os colegas com quem você o compartilhou ou enviá-lo para aprovação do administrador, que é o que o deixa visível para a organização inteira.

Para usar, abra o Microsoft 365 Copilot, digite @ e escolha o agente. Cada pessoa autoriza com a própria conta Coodesh na primeira vez e enxerga apenas as áreas de trabalho que ela mesma marcou.

O caminho pelo centro de administração do Microsoft 365 (Copilot > Conectores > Conectar ao servidor MCP) não serve para a Coodesh: ele exige um registro OAuth com ID e segredo de cliente no Portal do Desenvolvedor do Teams, e nós não emitimos segredo de cliente. Use o Copilot Studio.

Como saber se deu certo

Peça algo simples ao assistente, como "quais áreas de trabalho da Coodesh eu posso acessar?". Ele deve responder com o seu nome e a lista de áreas que você autorizou. Se responder que não tem acesso a nenhuma ferramenta da Coodesh, a conexão ainda não foi autorizada.

Com a conexão ativa, o assistente consegue, por exemplo:

  • consultar vagas, o painel de vagas e candidaturas, e alterar o status de uma candidatura;

  • listar e detalhar avaliações, e convidar pessoas para uma avaliação;

  • consultar a biblioteca de questões da Coodesh e a biblioteca da sua empresa;

  • consultar as pessoas da área de trabalho e o plano contratado.

Se algo der errado

  • O endereço precisa terminar em /mcp, sem barra no final. https://coodesh.com sozinho não funciona.

  • Escolha sempre HTTP (Streamable HTTP). Se o cliente tentar SSE ou stdio, a conexão falha.

  • "Authentication required" ou erro 401 antes de autorizar é esperado. É o servidor pedindo o login. Use o comando de autenticação do seu assistente: /mcp no Claude Code, Autenticar no ChatGPT, codex mcp login no Codex, Auth no VS Code.

  • O navegador não abriu, ou a tela expirou. A autorização tem validade de 10 minutos. Repita o passo de autenticação e conclua sem pausas longas.

  • O assistente pede um token ou chave de API. Não temos chave para MCP. Deixe o campo vazio e conclua pelo navegador.

  • O Copilot Studio pede ID e segredo de cliente. Você está na opção Manual do OAuth 2.0. Volte e escolha Descoberta dinâmica: o registro do cliente é automático.

  • Não aparece nenhuma área de trabalho na tela de autorização. Sua conta precisa ser de empresa e ter perfil de administrador, gestor ou usuário de empresa em pelo menos uma área de trabalho. Peça a quem administra a conta para incluir você.

  • O assistente não enxerga uma área de trabalho nova. O acesso é fixado no momento da autorização. Reconecte e marque a área que faltava.

  • Você trocou de conta na Coodesh. Desconecte o assistente em Minha conta > Segurança e conecte de novo com a conta certa.

Permissões e desconexão

O assistente nunca tem mais permissões do que você já tem, e o acesso vale apenas para as áreas de trabalho que você selecionou. Para revisar ou revogar, vá em Minha conta > Segurança, no cartão Assistentes conectados. O detalhe de cada permissão está em Como conectar seu assistente de IA (MCP).

Para o prazo da autorização, o que acontece quando alguém sai da empresa e a revisão pelo administrador, veja Segurança das conexões MCP.

Artigos relacionados
Respondeu à sua pergunta?