myBrain

myBrain MCP

myBrain は、あなた専用のナレッジベースです。アップロード、リンク、記録、または作成したものはすべて、検索、探索、推論に利用できるナレッジグラフになります。このリポジトリは、MCP サーバーのエントリーポイントと、AI エージェントがあなたのナレッジベースを効果的に活用する方法を学ぶためのファイルを公開しています。

エンドポイント	トランスポート	認証
https://mcp.mybrain.ai/mcp/	ストリーミング可能な HTTP	OAuth 2.1 サインイン、または Authorization: Bearer <MCP API key>

URL の末尾にスラッシュを付けてください。

OAuth に対応するクライアント（claude.ai、ChatGPT、Claude Code）は、URL だけで接続できます。myBrain のサインイン画面が開くので、同意画面で許可する内容を選ぶと、クライアント専用のトークンが発行されます。それ以外のクライアントでは、myBrain で作成した MCP API キーを使用します。Settings → Connected Apps → MCP Integrations から作成できます。

どちらもスコープに対応しています。mcp:read（検索および読み取りツール）、mcp:write（ソースの追加、承認、メモリのインポート）、mcp:orchestrator（ask_mybrain）。サインイン済みアプリと API キーは同じ Settings ページに表示され、そこでアクセスを取り消すと、すぐに無効になります。

接続

claude.ai（Claude のデスクトップアプリおよびモバイルアプリでも使用）：Settings → Connectors → Add custom connector を選択し、https://mcp.mybrain.ai/mcp/ を貼り付けて、myBrain にサインインします。

ChatGPT（Developer mode を利用できるプラン）：Settings → Apps & Connectors → Advanced settings → Developer mode をオンにしてから、URL https://mcp.mybrain.ai/mcp/ と認証方式 OAuth を指定してコネクターを作成し、myBrain にサインインします。

Claude Code にサインインする場合：

claude mcp add --transport http mybrain https://mcp.mybrain.ai/mcp/
claude mcp login mybrain   # or /mcp inside a session

API キーを使用する場合：

claude mcp add --transport http mybrain https://mcp.mybrain.ai/mcp/ --header "Authorization: Bearer YOUR_MCP_API_KEY"

Claude Desktop（設定ファイル）、Cursor、VS Code（クライアント設定の mcpServers）：

{
  "mcpServers": {
    "mybrain": {
      "url": "https://mcp.mybrain.ai/mcp/",
      "headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
    }
  }
}

エージェントに使い方を教える

サーバーを接続するだけでは不十分です。エージェントには、質問する代わりにいつナレッジベースを検索するか、どのツールのコストが低いか、また、書き込みはすべて承認待ちのソースになることも教える必要があります。クライアントに合ったものを選んでください。

ファイル	用途
skill/mybrain/SKILL.md	Claude Code のスキルです。skill/mybrain/ フォルダーを ~/.claude/skills/（個人用）または <project>/.claude/skills/（プロジェクト用）にコピーします。
templates/CLAUDE.md	プロジェクトまたはグローバルな CLAUDE.md に貼り付けるブロックです。
templates/AGENTS.md	AGENTS.md を読み込むクライアント（Codex、Cursor、その他）向けの同じガイダンスです。

3 つとも、サーバーが mybrain として接続されていることを前提としています（Claude Code でのツール名は mcp__mybrain__*）。

ツール

読み取り（mcp:read）：recall_memories、list_memories、search_user_knowledge、search_passages、read_source_passages、search_knowledge、search_sources、list_sources、explore_node、trace_path、get_knowledge_overview、list_knowledge_fields、get_knowledge_node、get_related_concepts、list_chat_threads、get_chat_history、get_suggested_questions、get_ingestion_status、get_usage_summary。

書き込み（mcp:write）：add_source_text、add_source_url、add_source_youtube、approve_source、import_memories。書き込みは myBrain で承認待ちのソースとして登録され、承認後にのみ処理されます。

質問（mcp:orchestrator）：ask_mybrain。引用を含む、ナレッジベース全体から合成された回答を返します。レート制限があり、プランの利用枠を消費します。

レジストリ

server.json は、公式 MCP Registry に io.github.mybrain-ai/mcp として公開されるマニフェストです。

公開（メンテナーのみ）には、mybrain-ai 組織の Owner 権限が必要です。対話式の mcp-publisher login github で付与されるのは個人の名前空間へのアクセスのみです（registry#1468）。代わりに PAT でログインしてください（classic の場合は read:org、fine-grained の場合は「Organization → Members → Read-only」）。mcp-publisher は 1.8.1 以降を使用してください。

./mcp-publisher login github --token "$GH_PAT"
./mcp-publisher publish

公開済みのバージョンは変更できないため、server.json を変更するたびに、新しい version を指定して公開してください。

ライセンス

このリポジトリ内のファイルは、MIT License の下で公開されています。 マークについては、TRADEMARKS.md をご覧ください。myBrain サービスと mcp.mybrain.ai を支えるサーバーコードは、このリポジトリには含まれていません。