Ligar outros clientes MCP

Além do Claude e do ChatGPT, funciona qualquer cliente MCP que suporte servidores remotos por HTTP e início de sessão com OAuth – por exemplo IDEs como o Cursor, ou o MCP Inspector para testes. Este artigo destina-se a quem configura um cliente destes por conta própria ou cria a sua própria integração.

#Dados essenciais

URL do servidor

https://dock.at-harbor.com/mcp

Transporte

Streamable HTTP, sem estado. Cada pedido é um POST com uma mensagem JSON-RPC (ou um lote), e a resposta chega como JSON. Não há ID de sessão nem stream do servidor.

Versões do protocolo

2025-11-25, 2025-06-18 e 2025-03-26

Métodos

initialize, ping, tools/list e tools/call. O servidor não oferece resources nem prompts.

Início de sessão

OAuth 2.1 com PKCE (S256). Sem token, o servidor responde com 401 e indica os seus metadados no cabeçalho WWW-Authenticate.

#Configurar um cliente

1. No seu cliente, adicione um servidor MCP remoto (muitas vezes chamado «Remote», «HTTP» ou «Streamable HTTP»)
2. Introduza https://dock.at-harbor.com/mcp como URL
3. Deixe o client ID e o secret em branco – o cliente regista-se sozinho
4. Inicie a ligação; o início de sessão abre-se no seu navegador, seguido da página de consentimento do LinkHarbor
5. Escolha o espaço de trabalho e as permissões e clique em «Permitir»

O nome desta definição varia de programa para programa. No MCP Inspector, por exemplo, escolhe o transporte «Streamable HTTP».

#O fluxo OAuth em detalhe

1. O cliente chama o servidor MCP sem token e recebe 401 com uma indicação dos metadados do recurso
2. Lê os metadados do servidor de autorização (endpoints, métodos suportados, permissões)
3. Regista-se: via Dynamic Client Registration ou com um documento de metadados do cliente num URL https
4. Abre o navegador com o pedido de autorização, incluindo PKCE e resource=https://dock.at-harbor.com/mcp
5. Inicia sessão e decide na página de consentimento
6. O cliente troca o código por um access token e um refresh token

Se um cliente não pedir nenhuma permissão, são pedidas todas; pode restringi-las na página de consentimento. Se um refresh token já substituído for usado de novo, o LinkHarbor termina toda a ligação por motivos de segurança.

#Regras para endereços de redirecionamento

• Endereços https
• http apenas para endereços de loopback no seu próprio computador (para clientes de computador e IDEs)
• Esquemas de app próprios em notação de domínio invertido
• No máximo 10 endereços por cliente, sem fragmentos

Se uma app enviar um endereço que não está registado para ela, o LinkHarbor interrompe: «A app enviou um endereço de retorno que não está registado para ela. O pedido foi interrompido.»

#Endereços de descoberta para programadores

#Apps desconhecidas

As apps cujos endereços de redirecionamento estão todos em claude.ai, claude.com, chatgpt.com ou openai.com contam como conhecidas. Os programas no seu próprio computador que regressam via localhost – como o Claude Code, o Codex e IDEs – mostram na página de consentimento a nota «O LinkHarbor não conhece esta app. Está a ser executada no seu próprio computador. Continue apenas se acabou de a iniciar» e, em baixo, «Depois da sua escolha, regressa à app no seu computador». As outras apps web desconhecidas mostram «O LinkHarbor não conhece esta app. Continue apenas se iniciou este pedido e confia em …», com o respetivo endereço no lugar das reticências. Ambas as notas são normais se acabou de configurar o cliente. Só aparece um logótipo se a app enviar um. Se não foi o próprio a iniciar o início de sessão, clique em «Recusar».