Servidor MCP: o CliLink no seu assistente de IA

O que é

MCP (Model Context Protocol) é o jeito padrão de ligar um assistente de IA a um sistema. Com o servidor MCP do CliLink, o assistente que você usa consulta a agenda, procura horários livres, marca, remarca e cancela consultas, busca pacientes e lê ou ajusta os textos da página, tudo com as permissões do token. As ferramentas que mudam algo vão marcadas como destrutivas: o assistente mostra o que vai fazer e pede a sua confirmação.

• Endereço: https://app.clilink.bio/api/mcp
• Transporte: Streamable HTTP, sem sessão (cada pedido é um POST).
• Dois jeitos de entrar: login do CliLink (OAuth), para o claude.ai, o ChatGPT e outros apps que pedem login, ou o token da API no cabeçalho Authorization, para o Claude Code, o Claude Desktop, o VS Code e o Cursor.
• O token se cria em Configurações > Conta > Avançado > Integrações com o modelo Assistente de IA (MCP), ou só com leitura se preferir que ele não mude nada.

Claude Code

claude mcp add --transport http clilink https://app.clilink.bio/api/mcp \
  --header "Authorization: Bearer clk_..."

Depois, /mcp mostra o CliLink ligado. Peça, por exemplo: "quais consultas tenho amanhã?".

Claude Desktop

Em Configurações > Desenvolvedor > Editar configuração, abra o claude_desktop_config.json e acrescente o CliLink (precisa do Node.js instalado). Feche e abra o Claude Desktop de novo.

{
  "mcpServers": {
    "clilink": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.clilink.bio/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer clk_..."
      }
    }
  }
}

O mcp-remote é a ponte oficial da comunidade entre o Claude Desktop e servidores MCP remotos com cabeçalho de autenticação. Escreva Authorization: colado no valor, sem espaço, como no exemplo.

claude.ai (navegador e app do Claude)

Precisa de um plano do Claude que aceite conectores personalizados. Nos planos de equipe, quem administra a organização adiciona o conector.

• No claude.ai, abra Configurações > Conectores e toque em Adicionar conector personalizado.
• Nome: CliLink. Endereço: https://app.clilink.bio/api/mcp. Deixe as opções avançadas (ID e segredo do cliente) em branco: o CliLink registra o Claude sozinho.
• Toque em Conectar. Abre a tela do CliLink: entre com a sua conta (e o código das duas etapas, se tiver ligado), confira o nome do app, marque o que ele pode fazer e toque em Permitir.
• Numa conversa, ligue o CliLink no menu de ferramentas e peça, por exemplo: "quais consultas tenho amanhã?".

O conector vale também no app do Claude no celular e no computador, na mesma conta do Claude.

ChatGPT

Os conectores próprios do ChatGPT ficam no modo desenvolvedor e dependem do plano e da liberação na conta (ou no workspace) do ChatGPT.

• No ChatGPT, abra Configurações > Aplicativos e conectores > Configurações avançadas e ligue o modo desenvolvedor.
• Em Aplicativos e conectores, toque em Criar. Nome: CliLink. URL do servidor MCP: https://app.clilink.bio/api/mcp. Autenticação: OAuth.
• Confirme que confia no conector e toque em Criar. O ChatGPT abre a tela do CliLink: entre, marque as permissões e toque em Permitir.
• Numa conversa, escolha o CliLink nas ferramentas do modo desenvolvedor.

Os nomes dos menus do claude.ai e do ChatGPT mudam de vez em quando; o endereço do servidor é sempre o mesmo.

Login do CliLink (OAuth): como funciona

• OAuth 2.1 da especificação de autorização do MCP (versão 2025-11-25): o servidor responde 401 com WWW-Authenticate apontando o https://app.clilink.bio/.well-known/oauth-protected-resource/api/mcp, e o servidor de autorização se descreve em https://app.clilink.bio/.well-known/oauth-authorization-server.
• Registro dinâmico de cliente (RFC 7591) em /api/oauth/register, com limites por endereço e até 5 endereços de retorno (https, este computador ou o esquema de um app instalado).
• Authorization code com PKCE S256 obrigatório, endereço de retorno conferido ao pé da letra e o indicador de recurso (RFC 8707): o token só vale para este MCP.
• A tela de consentimento fica no painel e exige login. Você escolhe as permissões; são as mesmas dos tokens da API e não existe permissão de prontuário.
• Token de acesso de 1 hora e token de renovação de 30 dias, trocado a cada uso. Se um token de renovação já usado aparecer de novo, a conexão cai na hora.
• Desconectar: Configurações > Conta > Avançado > Integrações > Apps. O app também pode desligar a conexão pelo /api/oauth/revoke (RFC 7009).

Outros clientes MCP

{
  "servers": {
    "clilink": {
      "type": "http",
      "url": "https://app.clilink.bio/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:clilink-token}"
      }
    }
  },
  "inputs": [
    {
      "id": "clilink-token",
      "type": "promptString",
      "description": "Token do CliLink",
      "password": true
    }
  ]
}

{
  "mcpServers": {
    "clilink": {
      "url": "https://app.clilink.bio/api/mcp",
      "headers": {
        "Authorization": "Bearer clk_..."
      }
    }
  }
}

Qualquer cliente que fale Streamable HTTP e aceite um cabeçalho Authorization funciona do mesmo jeito.

Ferramentas

O assistente só vê as ferramentas que as permissões do token deixam. Token só com leitura não tem nenhuma ferramenta que mude algo.

Segurança

• Não existe ferramenta de prontuário: dado clínico não sai pelo MCP.
• O que o assistente lê vai para a empresa dele: confira a política de privacidade do assistente antes de ligar e prefira as permissões mínimas.
• Os mesmos limites da API (por token e por conta) e cada ferramenta chamada fica no histórico do painel, sem os dados.
• Revogar o token, ou desconectar o app em Apps, desliga o assistente na hora.