Документы для разработчиков Brain-MCP: инструменты для Claude AI, а не для людей

Разработчик, поддерживающий сервер Brain-MCP, который обеспечивает Claude память между диалогами, обнаружил, что основным потребителем их документации был Claude, а не люди, читающие GitHub. Они добавили раздел «Для ИИ-ассистентов» в начало README, содержащий поведенческие инструкции, а не просто описания инструментов.

Ключевые детали эксперимента

Разработчик создал отдельную страницу по адресу brainmcp.dev/for-ai с конкретными рекомендациями для ИИ-ассистентов. Поведенческие инструкции в README функционируют как системный промпт для использования инструментов.

Немедленное наблюдаемое отличие заключалось в том, что Claude начал использовать инструменты более разумно — не только когда его явно просили, но и проактивно добавляя релевантный контекст, когда пользователь менял тему.

Паттерн документации для потребления ИИ

Разработчик предлагает, что если ваш MCP-сервер используется ИИ, вам следует писать документацию специально для ИИ. Это включает:

• Не только названия инструментов и типы параметров
• Фактические рекомендации о том, когда и как эффективно использовать инструменты
• Поведенческие инструкции, которые влияют на то, как Claude использует инструменты

Конкретные примеры из документации

Документация включает практические рекомендации, такие как:

• Когда проактивно искать (например, когда пользователь говорит «на чём я остановился» → вызвать tunnel_state)
• Как представлять результаты («синтезируйте, не вываливайте сырые результаты поиска»)
• Когда НЕ искать (чистые команды, продолжение той же темы)

Технические детали

Сервер Brain-MCP можно установить с помощью: pipx install brain-mcp && brain-mcp setup

Проект включает 25 инструментов, работает на 100% локально и имеет лицензию MIT.

Разработчик спрашивает других разработчиков MCP, экспериментировали ли они с подобными подходами, чтобы влиять на то, как Claude использует их инструменты, выходя за рамки базовых описаний.