BrainTube MCP Server

Conecta BrainTube a cualquier IA

BrainTube incluye un servidor nativo del Protocolo de Contexto de Modelos (MCP), por lo que cualquier cliente de IA compatible con MCP puede leer tus transcripciones, resúmenes y destacados como contexto de primera clase.

¿Qué es MCP?

El Protocolo de Contexto de Modelos es un estándar abierto de Anthropic que ofrece a los clientes de IA una forma uniforme de leer contexto externo. En lugar de que cada herramienta cree una integración personalizada, un cliente habla MCP y el servidor expone sus datos y herramientas a través de esa interfaz compartida.

El servidor MCP de BrainTube es remoto y alojado: no hay nada que instalar. Apuntas un cliente compatible al endpoint, te autenticas y tu biblioteca guardada se vuelve consultable desde ese cliente.

Clientes compatibles

• Cualquier cliente MCP — Protocolo de Contexto de Modelos nativo. Mismo endpoint, misma configuración. Si tu asistente habla MCP, funciona: no se requiere integración de nuestra parte.
• Claude Desktop — Lee resúmenes, busca en transcripciones y pide a Claude que razone sobre tu biblioteca.
• Cursor — Incorpora charlas y tutoriales de ingeniería a tu flujo de codificación como contexto en vivo.
• ChatGPT — Se conecta en modo Desarrollador, o mediante OpenAPI para GPTs personalizados. Ambas vías en pruebas.
• Perplexity — Añade BrainTube como conector remoto personalizado para que las respuestas puedan basarse en tu propio material guardado junto con la web en vivo.
• VS Code · GitHub Copilot — Soporte MCP nativo en el modo agente de Copilot: incorpora charlas y documentos guardados como contexto junto al código.
• Gemini CLI — Añade el endpoint a tu settings.json y OAuth se detecta automáticamente. La app de chat de Gemini aún no admite conectores personalizados.
• Codex CLI — Se admite HTTP remoto por streaming: añade la URL y luego inicia sesión con codex mcp login.

Configuración

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

Claude.ai (un clic, OAuth): ve a Configuración → Conectores → Añadir conector personalizado. Primero escribe un nombre (por ejemplo, BrainTube), luego pega https://mcp.brain-tube.com/mcp en el campo URL e inicia sesión cuando se te solicite. No se necesita clave API: Claude.ai se conecta mediante OAuth.

Cursor, Claude Desktop, herramientas CLI y otros clientes MCP:

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

1. ¿Usas Claude.ai? Conéctate con el flujo OAuth de un clic de arriba y salta al paso 4. Para Cursor, Claude Desktop, herramientas CLI y cualquier otro cliente MCP, crea una clave API en Configuración → Claves API (https://app.brain-tube.com/settings).
2. Pega la configuración anterior en la configuración de tu cliente MCP (o añade la URL + el encabezado X-BrainTube-Token a través de la interfaz del cliente).
3. Reemplaza bt_your_key_here con tu clave real y reinicia el cliente.
4. Prueba: "Resume los últimos 5 videos que guardé sobre precios."

Herramientas MCP disponibles

Herramienta	Descripción
search_knowledge	Búsqueda de texto completo en tu corpus personal de conocimiento de BrainTube. Busca en YouTube, Instagram, web, LinkedIn, GitHub, Twitter y más. Clasificación híbrida (semántica + palabras clave, fusión por rango recíproco); las consultas en búlgaro/cirílico también se buscan en inglés.
get_video	Obtén detalles completos de un elemento guardado específico, incluidos transcripción, descripción, resumen y conclusiones clave. Pasa el ID del video de YouTube o el UUID interno.
list_recent	Lista tus elementos guardados más recientes en todos los tipos de fuente.
get_stats	Obtén estadísticas de tu corpus personal: total de elementos guardados, desglose por tipo de fuente, distribución de manchas.
get_related	Encuentra elementos semánticamente similares a un elemento dado mediante similitud vectorial.
search_by_source	Busca en tu corpus filtrado por un tipo de fuente específico (youtube, web, notion, twitter, pdf, etc.).
search_by_date_range	Búsqueda semántica limitada a elementos guardados entre dos fechas.
tag_item	Añade o elimina etiquetas en un elemento guardado.
list_bookmarks	Lista los marcadores guardados de tu corpus. Filtra por estado leído/no leído.
toggle_bookmark	Marca un elemento, elimina un marcador o alterna su estado leído/no leído.
connect_readwise	Conecta tu cuenta de Readwise a BrainTube guardando tu token de API de Readwise.
sync_readwise	Importa destacados de tu biblioteca de Readwise a tu corpus de BrainTube.
ingest_notion_page	Incorpora una sola página de Notion a tu corpus de BrainTube.
add_note	Escribe una nota o síntesis generada por IA de vuelta a un elemento específico de tu corpus.
get_recent_conversations	Recupera tus conversaciones más recientes guardadas de Claude y ChatGPT.
get_expertise_profile	Analiza tu corpus para construir un perfil de experiencia de conocimiento: experto, intermedio, superficial y puntos ciegos por tema.
get_session_brief	Inicio de sesión en una sola llamada: perfil de experiencia, últimas 5 conversaciones de IA y estadísticas del corpus en una única llamada.
ingest_content	Incorpora un solo contenido (nota, artículo, documento, etc.) a tu corpus de BrainTube.
bulk_ingest	Incorpora hasta 50 elementos en una sola llamada con deduplicación y embeddings.
random_resurface	Superficie de elementos olvidados de tu corpus mediante aleatoriedad ponderada.
ingest_notion_database	Incorpora todas las páginas de una base de datos de Notion a tu corpus de BrainTube.
set_notion_api_key	Guarda tu clave de API de integración de Notion para ingest_notion_page e ingest_notion_database.
backfill_embeddings	Genera embeddings vectoriales para todos los elementos que carecen de ellos. Requerido antes de la búsqueda semántica.
generate_api_key	Genera una clave API personal para Obsidian Sync CLI u otras integraciones. La clave se muestra una sola vez.
search_obsidian	Busca en tu bóveda local de Obsidian mediante el plugin Obsidian Local REST API.
chat_with_brain	Haz una pregunta a un Brain público de BrainTube (base de conocimiento curada). Devuelve respuesta + citas de fuentes.
list_brains	Lista todos los Brains que has creado con slug, nombre, número de elementos y visibilidad.
get_knowledge_graph	Construye un grafo de conocimiento alrededor de un elemento específico, mostrando cómo se conecta con otros mediante knowledge_edges.
knowledge_health	Ejecuta una verificación de salud de tu corpus de conocimiento: embeddings faltantes, elementos obsoletos, vacíos, puntuación general sobre 100.
get_knowledge_index	Obtén un índice a nivel de tema de todo tu corpus de conocimiento agrupado por tema principal.
export_corpus	Exporta todo tu corpus de conocimiento de BrainTube como un ZIP de archivos Markdown. Devuelve una URL de descarga firmada.
compile_knowledge	Genera artículos conceptuales a partir de un clúster de temas o un Brain mediante la función de borde compile-knowledge.
get_concept_articles	Consulta artículos conceptuales compilados de tu base de conocimiento, filtra por clúster, brain o texto de búsqueda.
tag_cooccurrence	Encuentra etiquetas que aparecen con frecuencia juntas en tu corpus.
entity_cooccurrence	Encuentra entidades nombradas (personas, organizaciones, herramientas) que coaparecen con frecuencia en tu corpus.
detect_gaps	Detecta vacíos de conocimiento: temas delgados, entidades sin profundidad, elementos valiosos obsoletos.
most_retrieved	Devuelve los elementos que recuperas con más frecuencia, clasificados por retrieval_count.
export_claude_md	Genera un archivo de contexto de conocimiento compatible con CLAUDE.md para cualquier proyecto de Claude Code.
recompute_salience	Activa un recálculo de puntuación de saliencia en todo tu corpus.
deep_search	Búsqueda de conocimiento multi-salto: búsqueda semántica + recorrido de grafo desde los mejores resultados.
retrieval_quality	Obtén un panel de calidad de recuperación: tasas de acierto de búsqueda, consultas con cero resultados, términos principales.
find_path	Encuentra la ruta más corta entre dos elementos en tu grafo de conocimiento.
compute_centrality	Recalcula las puntuaciones de centralidad de grafo en todo tu corpus.
get_edge_history	Obtén el historial temporal de bordes de conocimiento entre dos elementos específicos.

Endpoint y autenticación

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

La autenticación acepta un encabezado X-BrainTube-Token: bt_your_key_here o un encabezado Authorization: Bearer bt_your_key_here. Claude.ai puede usar OAuth en lugar de una clave API.

Crea y rota claves en https://app.brain-tube.com/settings.

Preguntas frecuentes

¿Qué es MCP y por qué BrainTube lo usa?

El Protocolo de Contexto de Modelos es un estándar abierto de Anthropic que permite a los clientes de IA leer contexto externo a través de una interfaz unificada. BrainTube incluye un servidor MCP nativo para que cualquier cliente compatible — Claude Desktop, Cursor, Zed — pueda consultar tu biblioteca sin integraciones personalizadas.

¿Qué clientes de IA funcionan con BrainTube hoy?

Cualquier cliente que hable MCP. Ese es el punto de construir sobre un estándar abierto en lugar de una integración a la vez: cuando un nuevo asistente incorpora soporte MCP, llega a tu biblioteca sin que nosotros tengamos que publicar nada. Claude Desktop y Cursor son los que se explican paso a paso a continuación; el soporte de ChatGPT está en pruebas. Cualquier cosa que hable MCP streamable-http usa el mismo endpoint y la misma configuración.

¿Necesito estar en un plan de pago para usar el servidor MCP?

No. El acceso MCP está incluido en todos los planes, incluido el gratuito. Lo que difiere según el nivel es la asignación de créditos: guardar elementos, ejecutar búsquedas y preguntar a tu brain consumen créditos, y los niveles superiores obtienen más. El gratuito comienza con 30 créditos al mes.

¿Dónde se almacena mi clave API y cómo la roto?

Las claves se crean en la aplicación BrainTube en Configuración → Claves API. Se muestran una sola vez al crearse, se almacenan con hash en reposo y se pueden rotar o revocar en cualquier momento. Cada clave tiene su propio registro de auditoría.

¿Puede BrainTube leer mis notas privadas o solo videos públicos?

BrainTube solo lee lo que guardas en tu propia biblioteca: videos públicos de YouTube, artículos que incorporas, PDFs que subes. Nunca rastrea cuentas de terceros en tu nombre.

¿Qué sucede con mis datos si desconecto un cliente?

Desconectar un cliente MCP elimina su acceso. Tu biblioteca, resúmenes y destacados permanecen intactos en BrainTube. Puedes reconectarte o exportar todo en cualquier momento.