nessie

Ligar o ChatGPT, o Claude e outras aplicações de IA

Ligar o Nessie ao ChatGPT, ao Claude, ao Claude Code ou a qualquer cliente MCP e definir o que pode fazer em nome de cada utilizador.

O endereço

Toda a aplicação de IA se liga ao Nessie num único endereço:

https://nessie.works/mcp

É tudo o que qualquer uma delas precisa. O início de sessão, o registo da aplicação e a escolha do que pode fazer acontecem todos no Nessie, num ecrã que indica o nome da aplicação e para onde a enviará de volta. Nunca é preciso copiar uma chave ou um token.

https://api.nessie.works/mcp é o mesmo servidor no seu endereço de API, o que o Nessie mostra em Definições › Segurança; qualquer um funciona. Quem executa o Nessie por conta própria deve usar o seu endereço de API com /mcp no fim.

ChatGPT

  1. Abra os Plugins do ChatGPT, carregue no sinal de mais (+) e escolha Adicionar servidor MCP personalizado.
  2. Dê o nome Nessie e, em Ligação, introduza https://nessie.works/mcp.
  3. Escolha OAuth para a autenticação. O ChatGPT regista-se a si próprio no Nessie; não há mais nada para preencher.
  4. Confirme o aviso sobre servidores personalizados e carregue em Criar como plugin.
  5. O ChatGPT abre o Nessie. Inicie sessão, se for pedido, escolha o que pode fazer e carregue em Permitir.

Poder adicionar um servidor personalizado depende do plano do ChatGPT e, num espaço de trabalho empresarial, do que os administradores permitirem. A OpenAI altera estes controlos de tempos a tempos; se os controlos parecerem diferentes, siga os passos atuais da OpenAI com o endereço acima.

Claude

No claude.ai, na aplicação para computador ou na aplicação para telemóvel:

  1. Aceda a Personalizar › Conectores e selecione Adicionar conector personalizado.
  2. Introduza https://nessie.works/mcp como URL do servidor. Deixe em branco o ID e o segredo do cliente OAuth.
  3. Se o Claude perguntar como deve identificar-se, escolha Registar automaticamente.
  4. Selecione Ligar. O Claude abre o Nessie, onde escolhe o que pode fazer e carrega em Permitir.

Num plano Team ou Enterprise, um proprietário adiciona o conector uma única vez, em Definições da organização › Conectores, e cada pessoa o liga depois com a sua própria conta do Nessie. Guia da Anthropic: Adicionar um conector que não está no diretório.

Claude Code

claude mcp add --transport http nessie https://nessie.works/mcp

Depois, execute /mcp numa sessão e escolha autenticar; o Claude Code abre o navegador. Não acrescente manualmente um cabeçalho Authorization.

Codex

codex mcp add nessie --url https://nessie.works/mcp
codex mcp login nessie

Qualquer outro cliente MCP

O Nessie fala HTTP streamable e o perfil de autorização MCP: OAuth 2.1 com PKCE (S256), registo dinâmico de clientes, tokens de renovação e indicadores de recurso. Um cliente que suporta servidores remotos com OAuth precisa apenas do endereço. Um agente de linha de comandos que não consegue abrir o navegador associa-se com um código curto; veja MCP e ferramentas ligadas.

O que decide quando liga

A aplicação funciona no Nessie em nome de quem a liga e só alcança o que essa pessoa consegue alcançar. No ecrã de aprovação, escolhe-se:

  • O que pode fazer. Ler e alterar quadros, ler documentos e escrevê-los como rascunhos, ler os Clientes, trabalhar nos Clientes, enviar mensagens a clientes e operar o site da sua equipa. O envio de mensagens a clientes e a operação do site ficam desligados até serem ativados. Publicar um documento nunca é uma permissão: a aplicação só pode pedir, e cada publicação tem de ser aprovada.
  • Que equipas. A equipa em que a pessoa está e quaisquer outras equipas da organização que sejam assinaladas. A aplicação trabalha numa equipa de cada vez e nunca move nada entre elas.

Uma ligação dura 90 dias. Depois disso, é preciso voltar a ligar a aplicação.

O que pode fazer

  • Tarefas: encontrar projetos e quadros, criar, editar e mover tarefas, comentar, anexar ficheiros e gerir etiquetas, tipos de tarefa e listas de verificação.
  • Documentos: ler os espaços de conhecimento, criar e editar documentos e folhas de cálculo, e pedir a publicação de um deles.
  • Clientes: ler e tratar a caixa de entrada de clientes por email, SMS, Facebook, Instagram e chat do site; manter contactos e listas de contactos; preparar campanhas de newsletter, que uma pessoa envia sempre; e ler os envios dos formulários de contacto.

Comece uma conversa com algo como «listar os meus projetos do Nessie».

Ver e desligar o que ligou

Cada aplicação ligada aparece no Nessie em Definições › Segurança › Programas com sessão iniciada em nome do utilizador, com o que pode fazer, as equipas que alcança e a data de última utilização. Revogar termina-a de imediato. Um proprietário da organização vê todas as ligações da organização e pode desativar por completo a ligação de aplicações, em Administração › Segurança › Programas com sessão iniciada em nome de pessoas.

Se algo correr mal

  • «Ligue o Nessie novamente.» Os 90 dias passaram, a ligação foi revogada ou a sessão foi terminada em todo o lado. Remova o Nessie da aplicação e adicione-o de novo.
  • «Este pedido de ligação expirou ou já foi respondido.» O ecrã de aprovação aguarda dez minutos. Inicie a ligação novamente a partir da aplicação.
  • Uma ferramenta diz que falta uma permissão. Não a assinalou quando permitiu o acesso à aplicação. Revogue a ligação e volte a ligar, assinalando-a.
  • «Esta ligação já não consegue chegar à equipa…» Saiu dessa equipa. As outras equipas da ligação continuam a funcionar; ligue de novo para a voltar a adicionar.

Para agentes e ferramentas que descobrem servidores

O Nessie publica os documentos padrão que um agente procura:

  • https://nessie.works/.well-known/ai-catalog.json e https://api.nessie.works/.well-known/ai-catalog.json — o AI Catalog, que indica o Server Card em https://api.nessie.works/mcp/server-card (MCP Server Cards, SEP-2127).
  • https://api.nessie.works/.well-known/oauth-protected-resource e https://api.nessie.works/.well-known/oauth-authorization-server — como iniciar sessão (RFC 9728 e RFC 8414). Uma chamada sem autenticação ao endpoint MCP aponta para o primeiro.
  • works.nessie/nessie no Registo oficial do MCP.
  • https://nessie.works/llms.txt — esta página e o restante da documentação, para um modelo de linguagem ler.