Suas notas, dentro do seu assistente de IA

Conecte o Cosmonote ao Claude, ao ChatGPT ou a outro assistente de IA. Ele vai poder ler suas gravações, transcrições, resumos e ações, e responder às suas perguntas sobre tudo isso.

Comece por aqui ↓

Para que serve

Depois de conectado, você pode perguntar ao seu assistente coisas como "o que a gente decidiu na reunião de segunda?" e ele vai buscar a resposta nas suas notas do Cosmonote. Sem copiar e colar, sem exportar.

Ele só consegue ler. Seu assistente nunca pode alterar, apagar nem gravar nada, e só enxerga as notas da sua própria conta.

MCP é o padrão aberto que torna isso possível. Você não precisa saber mais nada sobre ele para seguir os passos abaixo. Se preferir construir alguma coisa por conta própria, use a API REST.

Antes de começar

Você precisa de uma coisa só: uma chave de API do Cosmonote. Leva uns trinta segundos.

  1. Abra o app do Cosmonote no seu celular.
  2. Vá em Configurações → Chaves de API.
  3. Toque em Criar uma chave e copie.

Deixe ela à mão. Seu assistente pede uma vez, na hora de entrar, e nunca mais.

Conecte seu assistente

Escolha o que você usa. Todos os caminhos terminam igual: abre uma página de login do Cosmonote, você cola sua chave e pronto.

https://nebula.cosmonote.ai/mcp
Ir para: Claude Claude Code ChatGPT Cursor, Windsurf, Zed…

Claude

Web, computador e celular
  1. Abra o Claude e vá em Configurações → Conectores.
  2. Clique em Adicionar conector personalizado.
  3. Cole o endereço do Cosmonote no campo de URL: 
    https://nebula.cosmonote.ai/mcp
  4. Clique em Conectar. Abre uma página de login do Cosmonote.
  5. Cole sua chave de API e confirme. O Cosmonote já aparece na sua lista de conectores.

Claude Code

No terminal
  1. Rode este comando: 
    claude mcp add --transport http cosmonote https://nebula.cosmonote.ai/mcp
  2. Digite /mcp dentro do Claude Code e escolha Authenticate.
  3. Cole sua chave de API na página que abrir.

ChatGPT

Web e computador
  1. Abra o ChatGPT e vá em Configurações → Conectores.
  2. Procure Cosmonote no diretório. Se não estiver lá, escolha Adicionar conector personalizado e cole o endereço acima.
  3. Entre com sua chave de API quando ele pedir.

Cursor, Windsurf, Zed e os outros

Qualquer app compatível com MCP funciona igual. Adicione o Cosmonote ao arquivo de configuração dele, abra o app e conclua o login que ele oferece.

{
  "mcpServers": {
    "cosmonote": {
      "url": "https://nebula.cosmonote.ai/mcp"
    }
  }
}

A conexão usa Streamable HTTP com OAuth 2.0 e PKCE. Nada mais para configurar.

Experimente

Depois de conectado, pergunte o que quiser sobre o que você gravou.

Resuma minhas 3 últimas reuniões
Que decisões foram tomadas no alinhamento de ontem?
Liste todas as minhas ações em aberto com os prazos
O que a Sarah falou sobre o cronograma de lançamento?
Escreva um e-mail de follow-up a partir da reunião de hoje
Compare os pontos principais das minhas duas últimas aulas

O que ele consegue ver

Três ferramentas somente de leitura, todas limitadas à sua própria conta.

list_notes

Suas notas, com título, data, duração, participantes, categoria e pontos principais.

read-only
get_note

Uma nota inteira, com a transcrição e o resumo se você pedir.

read-only
list_action_items

As ações extraídas das suas notas, de uma nota ou de todas.

read-only

Referência técnica

Você não precisa de nada disso para conectar. Está aqui para quem vai integrar o Cosmonote em um app próprio.

Endpoint https://nebula.cosmonote.ai/mcp
Transporte Streamable HTTP (JSON-RPC)
Auth OAuth 2.0 + PKCE
Descoberta /.well-known/oauth-authorization-server
Acesso Somente leitura, limitado ao usuário

Se algo der errado

A conexão falha

Confira o endereço caractere por caractere. É https://nebula.cosmonote.ai/mcp, sem barra no final.

A página de login recusa minha chave

As chaves são copiadas inteiras, com prefixo e tudo. Na dúvida, crie uma nova em Configurações → Chaves de API e cole essa.

Conecta mas não acha nenhuma nota

Seu assistente só enxerga as notas da conta que emitiu a chave. Confira se você está na mesma conta do Cosmonote e se ela tem gravações.

Ainda travado

Escreva para [email protected] dizendo qual assistente você está conectando.