Ir para o conteúdo
nectar Documentação

Documentação / Conectar um cliente de IA

Conectar um cliente de IA

Deixe um cliente de IA, como um assistente de chat ou uma ferramenta de programação, ler sua biblioteca do Nectar e estes guias com um token pessoal.

Antes de começar

O acesso para IA é ativado pelo serviço. Se você não vê Acesso para IA nas Configurações, ele ainda não está disponível. O cliente precisa se conectar a um servidor MCP por HTTPS, diretamente ou por uma pequena ponte local.

Criar um token

  1. Abra as Configurações e encontre Acesso para IA.
  2. Escolha Criar um token. Você precisa ter entrado nos últimos 10 minutos; se não, o Nectar pede para entrar de novo.
  3. Dê ao token um nome que diga para qual cliente e dispositivo ele é, e escolha quando expira: de 1 a 90 dias, 30 por padrão.
  4. Escolha o que ele pode fazer. A leitura é o que as ferramentas usam hoje; as outras permissões são para ferramentas que vão alterar seus dados e ainda não fazem nada.
  5. Copie o token. Ele aparece uma única vez, e o Nectar guarda apenas uma impressão digital dele.

Conectar seu cliente

As configurações mostram o endereço ao qual o cliente se conecta, terminado em /mcp/me, e uma configuração pronta.

  • Clientes que aceitam um cabeçalho próprio se conectam a esse endereço com o cabeçalho Authorization: Bearer SEU_TOKEN.
  • Clientes que iniciam um comando local usam a ponte da configuração, com o endereço e seu token nos ajustes dela.

Guarde o token nas configurações do cliente, nunca numa mensagem de chat ou num arquivo que você compartilhe.

O que o cliente pode fazer

O cliente vê o que você vê no app, e nada mais:

  • me: sua conta, nível, sequência, meta diária e missões, e quantos pergaminhos e coleções você tem;
  • scrolls_list e scroll_inspect: sua biblioteca, os pergaminhos que são seus e o catálogo público, e um pergaminho com capítulos, ideias e exemplos;
  • collections_list e collection_inspect: suas coleções e as que você curtiu;
  • saved_list, review_list e revisit_due: ideias curtidas, pergaminhos salvos, Revisar depois e as ideias pendentes em Revisitar;
  • friends_list: seus amigos e pedidos de amizade;
  • docs_search e docs_read: estes guias, para o cliente explicar como o Nectar funciona.

Um cliente não pode ganhar XP nem progresso de leitura por você, mudar seu e-mail ou senha, nem excluir sua conta. Peça ao cliente que liste as ferramentas para ver exatamente o que seu token permite.

Proteja seus tokens

Você pode ter até 10 tokens ativos. Revogue um token nas configurações assim que parar de usá-lo ou achar que ele vazou; ele para de funcionar na hora. Um token também para de funcionar quando expira.