Guias

Ligue o Nubbo ao Claude, ChatGPT ou Cursor

Ligue o Claude, o ChatGPT ou o Cursor ao Nubbo em poucos minutos e peça-lhes o que precisar do seu armazenamento numa conversa.

O servidor MCP do Nubbo permite que o seu assistente de IA trabalhe com os seus ficheiros a partir da conversa. Neste guia liga-o ao Claude, ChatGPT ou Cursor e pede-lhe a sua primeira tarefa.

O que consegue

  • Pedir por palavras suas que pesquise ficheiros, crie links ou pedidos de ficheiros ou organize pastas.
  • Escolher ao ligar o espaço, o acesso e os buckets ou projetos que pode usar.
  • Ver na sua atividade tudo o que faz, com o nome da chave do assistente.

Antes de começar

Precisa de uma conta do Nubbo com o plano Pro ou Equipas e do Claude, ChatGPT ou Cursor num plano que permita conectores personalizados. Numa equipa, só o proprietário e os administradores podem ligar um assistente.

Passo 1: copie o endereço do servidor

No Nubbo, abra Definições › API (ou Equipa › API numa equipa) e copie o endereço do cartão Servidor MCP: https://api.nubbo.app/mcp.

Cartão Servidor MCP com o endereço para copiar Cartão Servidor MCP com o endereço para copiar

Passo 2: adicione o conector

Os menus de cada assistente podem aparecer no seu idioma.

Claude. Abra Customize › Connectors, prima + e Add custom connector. Escreva Nubbo como nome, cole o endereço e siga os passos até Add. Nos planos Team e Enterprise do Claude, o proprietário da organização adiciona-o em Organization settings › Connectors e cada pessoa prime Connect.

Janela do Claude para adicionar um conector personalizado com o endereço do Nubbo Janela do Claude para adicionar um conector personalizado com o endereço do Nubbo

ChatGPT. Abra chatgpt.com/plugins, prima + e Add custom MCP server. Escreva Nubbo como nome, cole o endereço em Server URL, escolha OAuth e crie o plugin. Depois instale-o e escreva @Nubbo no chat para o usar.

Cursor. O Cursor liga-se com uma chave de API. Crie uma em Definições › API, como no guia da API, e adicione o servidor a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "nubbo": {
      "url": "https://api.nubbo.app/mcp",
      "headers": { "Authorization": "Bearer nbk_a_sua_chave" }
    }
  }
}

Passo 3: inicie sessão no Nubbo

No Claude e no ChatGPT, ao ligar, o Nubbo abre-se com Ligar Claude ao Nubbo (ou o nome do seu assistente).

  1. Escolha o Espaço: o pessoal ou uma das suas equipas.
  2. Escolha o Acesso. Vem em Só de leitura. Mude para Leitura e escrita se quiser que possa criar ou mover coisas.
  3. Escolha o Alcance: Todo o espaço ou Buckets e projetos escolhidos.
  4. Prima Ligar e confirme com a sua palavra-passe (e com o código, se usar a verificação em dois passos). O Nubbo devolve-o ao seu assistente.
Ecrã Ligar Claude ao Nubbo com o espaço, o acesso e o alcance Ecrã Ligar Claude ao Nubbo com o espaço, o acesso e o alcance

Passo 4: peça-lhe algo

Escreva o que precisa, por exemplo: «Procura no Nubbo as fotos da pasta Catálogo-2026 e cria um link de partilha para capa-primavera.jpg que expire em 7 dias». Antes de usar uma ferramenta que altera algo, o seu assistente pode pedir-lhe permissão.

O Claude pede permissão para usar a ferramenta do Nubbo que cria um link O Claude pede permissão para usar a ferramenta do Nubbo que cria um link
Resposta do Claude com o link criado no Nubbo Resposta do Claude com o link criado no Nubbo

Passo 5: reveja ou revogue o acesso

Em Definições › API (ou Equipa › API), a chave do assistente aparece com Ligada a e o nome da app. No respetivo menu pode Revogar o acesso de imediato.

Chave ligada ao Claude no separador API do Nubbo Chave ligada ao Claude no separador API do Nubbo

Se algo falhar

O que aconteceO que fazer
«Precisa de permissão para gerir as chaves de API desta equipa.»Peça ao proprietário ou a um administrador que ligue o assistente, ou escolha o seu espaço pessoal.
«Este espaço já tem todas as chaves de API que o plano permite.»Revogue uma chave que não use em Definições › API (ou Equipa › API) e volte a ligar.
«O pedido expirou»Volte a ligar o Nubbo a partir do seu assistente.
O assistente diz que não pode alterar nadaA ligação é Só de leitura. Em Definições › API (ou Equipa › API), abra o menu da chave, prima Editar e escolha Leitura e escrita.

Saiba mais sobre o Nubbo no seu assistente de IA. Para automatizar com o seu próprio código, siga o guia da API.

Perguntas frequentes

O meu assistente pode ler os meus ficheiros encriptados?

Não. O Nubbo nunca lê o seu conteúdo encriptado nem o passa ao assistente. Para o abrir, o assistente envia-o para o Nubbo.

O que pode fazer o assistente?

Pesquisar, ler e organizar os seus ficheiros e criar links e pedidos de ficheiros, sempre com o acesso que escolheu ao ligar. Com Só de leitura não pode alterar nada.

Conta como utilização da API?

Sim. As ferramentas que o assistente usa contam como pedidos da API do seu espaço.

O que acontece se deixar de o usar?

A ligação termina sozinha se não for usada durante 90 dias. Para a voltar a usar, ligue o Nubbo de novo a partir do seu assistente.

Fontes

Passos verificados com estas páginas.