Nos planos Team e Enterprise do Claude, o conector da Coodesh precisa ser publicado uma vez pelo administrador da organização. Depois disso, cada pessoa do time conecta a própria conta. Este artigo mostra esse processo, tela a tela.
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). Para configurar outros assistentes, veja Como configurar o MCP no Claude, ChatGPT, Codex e Copilot.
Antes de começar
Requisito | Detalhe |
Plano do Claude | Team ou Enterprise. Nos planos Free, Pro e Max não existe configuração de organização: cada pessoa adiciona o conector direto em Configurações > Customizar > Conectores. |
Seu papel no Claude | Proprietário (Owner) ou Proprietário principal (Primary Owner). Outros papéis não enxergam a tela usada aqui. |
Plano da Coodesh | Conta de empresa com MCP incluso. |
Conta na Coodesh | Cada pessoa que for usar o conector precisa de login ativo e de estar em pelo menos uma área de trabalho. |
Chave de API | Não é necessária. A autorização é feita por OAuth, no navegador. |
Endereço do servidor: https://coodesh.com/mcp, sem barra no final. O endereço api.coodesh.com não responde ao MCP.
Sobre as imagens: as telas foram capturadas em uma organização de demonstração e na interface em português. O que você vê na sua conta é idêntico.
1. Abra a lista de conectores da organização
No Claude, vá em Configurações da organização e, no menu lateral, clique em Conectores, dentro de Bibliotecas e Acesso.
2. Escolha adicionar um conector personalizado
Clique em Adicionar conector, no canto superior direito da lista, e depois em Personalizado. A opção Todos disponíveis mostra só o catálogo pronto da Anthropic, onde a Coodesh não está.
3. Selecione o tipo Web
No submenu, escolha Web. O conector da Coodesh é um servidor remoto acessado por HTTPS. A opção Desktop serve para extensões instaladas em cada computador, o que não é o caso aqui.
4. Informe o nome e o endereço do servidor
Preencha os dois campos da etapa 1 de 2:
Nome:
Coodesh. É o rótulo que a equipe vai ver na lista de conectores.URL do servidor MCP:
https://coodesh.com/mcp
O botão Continuar só é liberado depois que os dois campos estiverem preenchidos.
5. Confira as opções de autenticação
Ao avançar, o Claude consulta o servidor da Coodesh e preenche a etapa 2 sozinho. Duas opções aparecem com a etiqueta Detectado, o que confirma que o servidor respondeu:
Entrar agora: cada pessoa faz login pela Coodesh antes de usar qualquer ferramenta.
Registrar automaticamente: o Claude se registra como cliente OAuth no servidor conforme os usuários se conectam.
Não é preciso alterar nada nesta tela. Deixe em branco os campos de cliente OAuth próprio e de cabeçalhos de requisição.
6. Confira o transporte em Avançada
Opcional, mas vale conferir. Abra a seção Avançada e confirme que o transporte está em HTTP Streamable. O servidor da Coodesh não usa SSE.
A opção Autorização gerenciada aparece desativada quando a organização não usa um provedor de identidade compatível com SSO. Isso não impede o uso do conector.
7. Conclua com Adicionar
Clique em Adicionar. A mensagem Conector personalizado adicionado confirma a criação, e a janela de detalhes abre em seguida.
8. Ajuste as permissões, se quiser
Ainda na janela de detalhes, duas abas permitem refinar o conector para toda a organização:
Configuração: métodos de login habilitados. Pelo menos um precisa continuar ativo.
Ferramentas: restrições por ferramenta, caso você queira liberar só parte do que o servidor oferece.
9. Confirme o conector na lista
Feche a janela. O conector Coodesh passa a aparecer na lista com o tipo Web / Personalizado e autorização Individual, indicando que cada membro fará o próprio login.
O que cada pessoa do time faz depois
Publicar o conector não dá acesso a dado nenhum por si só: ele apenas passa a aparecer na lista de conectores disponíveis. Cada pessoa precisa conectar a própria conta:
No Claude, abrir Configurações > Customizar > Conectores.
Localizar Coodesh na lista e clicar em Conectar.
Fazer login na tela de autorização da Coodesh, que abre no navegador.
Selecionar quais áreas de trabalho o assistente poderá acessar.
Clicar em Autorizar.
Para validar, peça ao assistente: "quais áreas de trabalho da Coodesh eu posso acessar?". Ele deve listar as áreas autorizadas.
O assistente nunca tem mais permissão do que a pessoa que o autorizou, e o acesso vale apenas para as áreas de trabalho selecionadas.
Como remover ou revogar o acesso
Você, administrador: remova o conector pelo menu de opções na lista de conectores da organização. Ele sai para todos os membros.
Cada pessoa: na Coodesh, em Minha conta > Segurança, o cartão Assistentes conectados lista as autorizações ativas. O botão Desconectar revoga o acesso na hora.
Se algo der errado
Sintoma | O que verificar |
O servidor não responde | A URL precisa terminar em |
Erro 401 antes de autorizar | É o esperado. O servidor exige OAuth e só responde depois do login. |
A autorização não conclui | A tela de autorização expira em 10 minutos. Recomece o fluxo de conexão. |
O assistente não lista nada | Confirme que a pessoa pertence a alguma área de trabalho e que selecionou ao menos uma na tela de autorização. |
Erro de transporte | Use HTTP Streamable. O servidor não aceita SSE nem stdio. |
A tela de organização não aparece | Ela existe apenas nos planos Team e Enterprise, e apenas para Proprietários. |
A documentação da Anthropic sobre conectores personalizados está em Get started with custom connectors using remote MCP. Se a dúvida for da Coodesh, fale com a gente pelo chat da plataforma.