BrainTube MCP Server

Conecte o BrainTube a Qualquer IA

O BrainTube inclui um servidor nativo do Model Context Protocol (MCP), para que qualquer cliente de IA compatível com MCP possa ler suas transcrições, resumos e destaques como contexto de primeira classe.

O que é MCP?

O Model Context Protocol é um padrão aberto da Anthropic que oferece aos clientes de IA uma forma uniforme de ler contexto externo. Em vez de cada ferramenta criar uma integração personalizada, um cliente fala MCP e o servidor expõe seus dados e ferramentas por meio dessa interface compartilhada.

O servidor MCP do BrainTube é remoto e hospedado — não há nada para instalar. Você aponta um cliente compatível para o endpoint, autentica, e sua biblioteca salva se torna consultável dentro desse cliente.

Clientes suportados

• Qualquer cliente MCP — Model Context Protocol nativo. Mesmo endpoint, mesma configuração. Se seu assistente fala MCP, funciona — sem necessidade de integração da nossa parte.
• Claude Desktop — Leia resumos, pesquise transcrições e peça ao Claude para raciocinar sobre sua biblioteca.
• Cursor — Traga palestras e tutoriais de engenharia para seu fluxo de codificação como contexto ao vivo.
• ChatGPT — Conecta no modo Developer, ou via OpenAPI para GPTs personalizados. Ambos os caminhos em teste.
• Perplexity — Adicione o BrainTube como um conector remoto personalizado para que as respostas possam usar seu próprio material salvo junto com a web ao vivo.
• VS Code · GitHub Copilot — Suporte nativo a MCP no modo agente do Copilot — traga palestras e documentos salvos como contexto ao lado do código.
• Gemini CLI — Adicione o endpoint ao seu settings.json e o OAuth é descoberto automaticamente. O aplicativo de chat do Gemini ainda não aceita conectores personalizados.
• Codex CLI — Suporte a HTTP remoto por streaming — adicione a URL e faça login com codex mcp login.

Configuração

Endpoint: https://mcp.brain-tube.com/mcp

Claude.ai (um clique, OAuth): vá em Configurações → Conectores → Adicionar conector personalizado. Primeiro digite um nome para ele (ex.: BrainTube), depois cole https://mcp.brain-tube.com/mcp no campo URL e faça login quando solicitado. Nenhuma chave de API é necessária — o Claude.ai conecta via OAuth.

Cursor, Claude Desktop, ferramentas CLI e outros clientes MCP:

{
  "mcpServers": {
    "braintube": {
      "type": "streamable-http",
      "url": "https://mcp.brain-tube.com/mcp",
      "headers": {
        "X-BrainTube-Token": "bt_your_key_here"
      }
    }
  }
}

1. Usa Claude.ai? Conecte com o fluxo OAuth de um clique acima e pule para o passo 4. Para Cursor, Claude Desktop, ferramentas CLI e qualquer outro cliente MCP, crie uma chave de API em Configurações → Chaves de API (https://app.brain-tube.com/settings).
2. Cole a configuração acima no arquivo de configuração do seu cliente MCP (ou adicione a URL + o cabeçalho X-BrainTube-Token pela interface do cliente).
3. Substitua bt_your_key_here pela sua chave real e reinicie o cliente.
4. Experimente: "Resuma os últimos 5 vídeos que salvei sobre preços."

Ferramentas MCP disponíveis

Ferramenta	Descrição
search_knowledge	Busca de texto completo no seu corpus pessoal de conhecimento do BrainTube. Pesquisa em YouTube, Instagram, web, LinkedIn, GitHub, Twitter e mais. Classificação híbrida (semântica + palavras-chave, fusão por classificação recíproca); consultas em búlgaro/cirílico também são pesquisadas em inglês.
get_video	Obtenha detalhes completos de um item salvo específico, incluindo transcrição, descrição, resumo e principais conclusões. Informe o ID do vídeo do YouTube ou o UUID interno.
list_recent	Liste seus itens salvos mais recentes em todos os tipos de fonte.
get_stats	Obtenha estatísticas do seu corpus pessoal: total de itens salvos, detalhamento por tipo de fonte, distribuição de taint.
get_related	Encontre itens semanticamente semelhantes a um item específico usando similaridade vetorial.
search_by_source	Pesquise seu corpus filtrado por um tipo de fonte específico (youtube, web, notion, twitter, pdf, etc).
search_by_date_range	Busca semântica limitada a itens salvos entre duas datas.
tag_item	Adicione ou remova tags em um item salvo.
list_bookmarks	Liste marcadores salvos do seu corpus. Filtre por status lido/não lido.
toggle_bookmark	Marque um item, remova um marcador ou alterne seu estado lido/não lido.
connect_readwise	Conecte sua conta do Readwise ao BrainTube salvando seu token de API do Readwise.
sync_readwise	Importe destaques da sua biblioteca do Readwise para seu corpus do BrainTube.
ingest_notion_page	Ingira uma única página do Notion no seu corpus do BrainTube.
add_note	Escreva uma nota ou síntese gerada por IA de volta em um item específico do seu corpus.
get_recent_conversations	Recupere suas conversas mais recentes salvas do Claude e do ChatGPT.
get_expertise_profile	Analise seu corpus para criar um perfil de expertise em conhecimento — especialista, intermediário, superficial e pontos cegos por tópico.
get_session_brief	Inicialização de sessão em uma única chamada: perfil de expertise, últimas 5 conversas de IA e estatísticas do corpus em uma única chamada.
ingest_content	Ingira um único conteúdo (nota, artigo, documento, etc.) no seu corpus do BrainTube.
bulk_ingest	Ingira até 50 itens em uma única chamada com deduplicação e embeddings.
random_resurface	Traga à tona itens esquecidos do seu corpus usando aleatoriedade ponderada.
ingest_notion_database	Ingira todas as páginas de um banco de dados do Notion no seu corpus do BrainTube.
set_notion_api_key	Salve sua chave de API de integração do Notion para ingest_notion_page e ingest_notion_database.
backfill_embeddings	Gere embeddings vetoriais para todos os itens que estiverem sem eles. Necessário antes da busca semântica.
generate_api_key	Gere uma chave de API pessoal para o Obsidian Sync CLI ou outras integrações. A chave é mostrada apenas uma vez.
search_obsidian	Pesquise seu cofre local do Obsidian via o plugin Obsidian Local REST API.
chat_with_brain	Faça uma pergunta a um Brain público do BrainTube (base de conhecimento curada). Retorna resposta + citações das fontes.
list_brains	Liste todos os Brains que você criou com slug, nome, contagem de itens e visibilidade.
get_knowledge_graph	Construa um grafo de conhecimento em torno de um item específico, mostrando como ele se conecta a outros via knowledge_edges.
knowledge_health	Execute uma verificação de integridade no seu corpus de conhecimento: embeddings ausentes, itens desatualizados, lacunas, pontuação geral de 0 a 100.
get_knowledge_index	Obtenha um índice por tópico de todo o seu corpus de conhecimento agrupado por tópico principal.
export_corpus	Exporte todo o seu corpus de conhecimento do BrainTube como um ZIP de arquivos Markdown. Retorna uma URL de download assinada.
compile_knowledge	Gere artigos conceituais a partir de um cluster de tópicos ou Brain via a função de borda compile-knowledge.
get_concept_articles	Consulte artigos conceituais compilados da sua base de conhecimento, filtrando por cluster, brain ou texto de busca.
tag_cooccurrence	Encontre tags que aparecem com frequência juntas no seu corpus.
entity_cooccurrence	Encontre entidades nomeadas (pessoas, organizações, ferramentas) que coaparecem com frequência no seu corpus.
detect_gaps	Detecte lacunas de conhecimento: tópicos superficiais, entidades sem profundidade, itens de alto valor desatualizados.
most_retrieved	Retorne os itens que você recupera com mais frequência, classificados por retrieval_count.
export_claude_md	Gere um arquivo de contexto de conhecimento compatível com CLAUDE.md para qualquer projeto do Claude Code.
recompute_salience	Dispare um recálculo do score de saliência no seu corpus.
deep_search	Busca de conhecimento multi-salto: busca semântica + travessia de grafo a partir dos principais resultados.
retrieval_quality	Obtenha um painel de qualidade de recuperação: taxas de acerto de busca, consultas sem resultados, principais termos.
find_path	Encontre o caminho mais curto entre dois itens no seu grafo de conhecimento.
compute_centrality	Recalcule os scores de centralidade do grafo no seu corpus.
get_edge_history	Obtenha o histórico temporal das arestas de conhecimento entre dois itens específicos.

Endpoint e autenticação

Endpoint: https://mcp.brain-tube.com/mcp (MCP streamable-http)

A autenticação aceita um cabeçalho X-BrainTube-Token: bt_your_key_here ou um cabeçalho Authorization: Bearer bt_your_key_here. O Claude.ai pode usar OAuth em vez de uma chave de API.

Crie e alterne chaves em https://app.brain-tube.com/settings.

Perguntas frequentes

O que é MCP e por que o BrainTube o usa?

O Model Context Protocol é um padrão aberto da Anthropic que permite que clientes de IA leiam contexto externo por meio de uma interface unificada. O BrainTube inclui um servidor MCP nativo para que qualquer cliente compatível — Claude Desktop, Cursor, Zed — possa consultar sua biblioteca sem integrações personalizadas.

Quais clientes de IA funcionam com o BrainTube hoje?

Qualquer cliente que fale MCP. Esse é o objetivo de construir sobre um padrão aberto em vez de uma integração por vez — quando um novo assistente adiciona suporte a MCP, ele alcança sua biblioteca sem que precisemos lançar nada. Claude Desktop e Cursor são os que têm passo a passo abaixo; o suporte ao ChatGPT está em teste. Qualquer coisa que fale MCP streamable-http usa o mesmo endpoint e a mesma configuração.

Preciso estar em um plano pago para usar o servidor MCP?

Não. O acesso ao MCP está incluído em todos os planos, inclusive no Free. O que muda por nível é a cota de créditos: salvar itens, executar buscas e perguntar ao seu brain consomem créditos, e níveis mais altos têm mais. O Free começa com 30 créditos por mês.

Onde minha chave de API é armazenada e como faço para alterná-la?

As chaves são criadas no aplicativo do BrainTube em Configurações → Chaves de API. Elas são mostradas uma única vez na criação, armazenadas com hash em repouso e podem ser alternadas ou revogadas a qualquer momento. Cada chave tem seu próprio log de auditoria.

O BrainTube pode ler minhas notas privadas ou apenas vídeos públicos?

O BrainTube lê apenas o que você salva na sua própria biblioteca — vídeos públicos do YouTube, artigos que você ingere, PDFs que você envia. Ele nunca rastreia contas de terceiros em seu nome.

O que acontece com meus dados se eu desconectar um cliente?

Desconectar um cliente MCP remove o acesso dele. Sua biblioteca, resumos e destaques permanecem no BrainTube intactos. Você pode reconectar ou exportar tudo a qualquer momento.