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:

Abra o Claude Code e digite /mcp.
Selecione coodesh e depois Authenticate. O navegador abre na tela de autorização da Coodesh.
Faça login, escolha as áreas de trabalho e clique em Autorizar.
Para conferir, rode claude mcp list. O servidor deve aparecer como Connected.

Claude Desktop e claude.ai

Planos Free, Pro e Max:

Vá em Configurações > Customizar > Conectores.
Clique em Adicionar conector personalizado.
Informe a URL https://coodesh.com/mcp e clique em Adicionar. Deixe os campos de OAuth e de cabeçalhos vazios.
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)

Abra Configurações > Servidores MCP e clique em Adicionar servidor.
Dê o nome Coodesh, escolha Streamable HTTP e informe a URL https://coodesh.com/mcp.
Salve e clique em Reiniciar.
Na lista de servidores, clique em Autenticar e conclua a autorização no navegador.
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:

Abra a paleta de comandos (Ctrl+Shift+P ou Cmd+Shift+P) e execute MCP: Add Server.
Escolha HTTP, informe a URL https://coodesh.com/mcp e o nome coodesh.
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.

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.
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).

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