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.

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.

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).
- Escolha o Espaço: o pessoal ou uma das suas equipas.
- Escolha o Acesso. Vem em Só de leitura. Mude para Leitura e escrita se quiser que possa criar ou mover coisas.
- Escolha o Alcance: Todo o espaço ou Buckets e projetos escolhidos.
- 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.

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.


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.

Se algo falhar
| O que acontece | O 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 nada | A 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.