Сервер MCP (Model Context Protocol), который позволяет помощникам ИИ взаимодействовать с системой управления знаниями TheBrain. Этот сервер обеспечивает полный доступ к API TheBrain, уделяя особое внимание взаимодействию на естественном языке с мощными возможностями управления знаниями TheBrain.

Что такое MCP сервер?

MCP (Model Context Protocol) — это стандарт, который позволяет подключаться к внешним инструментам и сервисам. Думайте об этом как о переводчике между естественным языком и программными API.

###Как это работает:

1. ** Вы говорите **: «Создать проект с тремя фазами».
2. Клод понимает, чего вы хотите достичь
3. **MCP Server переводит ** это в конкретные вызовы API 4.TheBrain API создает мысли и связи
4. ** Ваш мозг обновляется с новой структурой

Магия в том, что вам не нужно знать никаких технических деталей - просто опишите, что вы хотите на простом английском языке!

###Что действительно работает

** Основные функции (работа) **

Управление контентом: Создавать, обновлять, удалять мысли и заметки ** Прикрепления к файлам**: Загружайте изображения, PDF-файлы, документы в мысли ** Веб-ссылки**: вложения URL с извлечением автозаголовка

TheBrain MCP Server

An MCP (Model Context Protocol) server that enables AI assistants to interact with TheBrain’s knowledge management system. This server provides comprehensive access to TheBrain’s API, focusing on natural language interaction with TheBrain’s powerful knowledge management capabilities.

🔧 What’s an MCP Server?

MCP (Model Context Protocol) is a standard that lets AI assistants like Claude connect to external tools and services. Think of it as a translator between natural language and software APIs.

How It Works:

You → Claude → MCP Server → TheBrain API → Your Brain

1. You say: “Create a project with three phases”
2. Claude understands what you want to accomplish
3. MCP Server translates this into specific TheBrain API calls
4. TheBrain API creates the thoughts and connections
5. Your Brain updates with the new structure

The magic is that you don’t need to know any technical details - just describe what you want in plain English!

🚀 What Actually Works

✅ Core Functionality (Working)

• Content Management: Create, update, delete thoughts and notes
• File Attachments: Upload images, PDFs, documents to thoughts
• Web References: URL attachments with auto-title extraction
• Rich Notes: Full Markdown support with embedded content
• Relationship Mapping: Connect thoughts with meaningful relationships
• Search: Full-text search across thoughts, notes, and attachments
• Brain Management: Switch between multiple brains seamlessly
• Natural Language Interface: Describe what you want, Claude handles the details

❌ Current Issues & Limitations

🚨 Major Visual Styling Problems

The biggest limitation: Visual properties don’t actually apply despite API success responses.

• ❌ Thought colors: API accepts colors but they don’t appear in TheBrain
• ❌ Link colors: Similar issue - accepted but not applied
• ❌ Link thickness: API reports success but thickness doesn’t change
• ❌ Visual formatting: All visual styling features are currently non-functional

🐛 Other Known Issues

• Intermittent connection problems: “Field required” errors after successful operations
• Long notes limitations: Issues with very long markdown content (keep under 10k characters)
• File path sensitivity: Requires absolute file paths; relative paths can fail
• Connection timing: MCP initialization race condition causing sporadic failures
• Memory constraints: Large file attachments can cause timeouts
• Search limitations: Complex queries sometimes return incomplete results

📋 API Dependencies & Constraints

• Single-user operations: No real-time collaboration features
• No bulk operations: Can’t import/export large datasets efficiently
• API connectivity required: No offline mode available
• TheBrain API limitations: Bound by existing API capabilities