AFFiNEのワークスペースMCPは、対応するAIクライアントからノートやホワイトボードのテキストを検索し、ドキュメントを読み取る接続先です。Streamable HTTPとBearerヘッダーに対応したクライアントは直接接続でき、ローカルstdioに対応したクライアントではブリッジを利用できます。
MCPはAIアシスタントを外部ツールやデータにつなぐオープン標準です。対応するAFFiNE Cloud・セルフホスト環境にはワークスペース用の接続先があります。直接接続にはStreamable HTTPとAuthorizationヘッダーが必要です。stdio専用クライアントにはmcp-remoteなどのローカルブリッジを使います。
接続すると、アシスタントはホワイトボードを含むナレッジベース全体をキーワード検索・セマンティック検索し、ドキュメント全文を読み取れます。権限はあなたが許可した範囲だけ。クライアントごとに個別の認証情報を発行し、それぞれ独立してローテーション・失効できるため、「AIにノートを見せる」が「全部を、永久に」になることはありません。
| これは何か | AFFiNE Cloudとセルフホスト版に内蔵された公式Model Context Protocolエンドポイント |
|---|---|
| エンドポイント | POST /api/workspaces/{workspace-id}/mcp |
| トランスポート | Streamable HTTP(ステートレス) |
| 認証 | Bearer認証情報(aff_mcp_v1. プレフィックス)。ワークスペース設定でクライアントごとに発行 |
| ツール | doc_search / read_document; READ_WRITE: development / canary |
| スコープ | 認証情報1つにつきワークスペース1つ。ドキュメント権限に準拠 |
| 料金 | AFFiNE Cloudでも、AI機能を有効にしたセルフホスト版でも無料 |
AFFiNE Cloudまたは対応する自分の環境に接続します。ワークスペースのBearer認証情報が必要で、ドキュメント権限が適用されます。以下は標準の読み取り専用ツールです。提供状況は環境によります。
https://app.affine.pro/api/workspaces/{workspace-id}/mcpdoc_searchread_document公開済みブログ記事とテンプレート専用の読み取りサービスです。アカウントや認証情報は不要です。自分のワークスペースの読み取りや文書の書き込みはできません。この接続先にワークスペースの認証情報を送らないでください。
https://affine.pro/api/public/mcpsearch_public_contentread_public_contentAFFiNEで認証情報を作成し、利用するクライアントの設定形式に合わせて接続します。
AFFiNEで「設定」→「Integrations」→「MCP Server」へ。AFFiNE Cloudと、AI機能を有効にしたセルフホスト版で利用できます。
「Create credential」をクリックし、ラベルを付けます(クライアントごとに1つ。例:「Claude Code」「Cursor」)。アクセスモードと有効期限を選択。既定は読み取り専用です。
AFFiNEから接続先と認証情報をコピーします。トークンの表示は一度だけです。全クライアントで同じJSONが使えるとは限らないため、以下の対応例を使ってください。
{
"mcpServers": {
"affine_workspace_<workspace-id>": {
"type": "streamable-http",
"url": "https://app.affine.pro/api/workspaces/<workspace-id>/mcp",
"headers": { "Authorization": "Bearer aff_mcp_v1...." }
}
}
}
AFFiNEが生成する接続情報の形式です。クライアントに合わせて調整してください。セルフホスト版では自分のサーバーのURLを使います。
通信方式と認証方式の両方を確認してください。Claude Code・Cursor・ClineはHTTPとBearerヘッダーを利用できます。OAuthログイン専用の接続画面では、この手動発行の認証情報は使えません。stdioブリッジを使えるのはローカルプロセスを起動できるクライアントです。
CLIコマンド1つでAFFiNEを追加。どのセッションからでもワークスペースの検索・読み取りをClaudeに頼めます。
claude mcp add --transport http affine \
"https://app.affine.pro/api/workspaces/<workspace-id>/mcp" \
--header "Authorization: Bearer <your-credential>"以下のURLとheadersを ~/.cursor/mcp.json に追加します。自分のワークスペースからコピーした接続先と認証情報を使ってください。JSON形式はクライアントによって異なります。
{
"mcpServers": {
"affine": {
"url": "https://app.affine.pro/api/workspaces/<id>/mcp",
"headers": {
"Authorization": "Bearer <your-credential>"
}
}
}
}ClineのMCP設定を開き、リモートのStreamable HTTPサーバーとしてAFFiNEを追加します。
{
"mcpServers": {
"affine": {
"type": "streamableHttp",
"url": "https://app.affine.pro/api/workspaces/<id>/mcp",
"headers": {
"Authorization": "Bearer <your-credential>"
}
}
}
}ローカルstdioプロセスを起動できるクライアント向けの設定です。サードパーティ製mcp-remoteと対応するNode.jsが必要です。ClaudeのWeb版OAuthコネクタとは異なります。
{
"mcpServers": {
"affine": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://app.affine.pro/api/workspaces/<workspace-id>/mcp",
"--header",
"Authorization:${AFFINE_MCP_AUTH}"
],
"env": {
"AFFINE_MCP_AUTH": "Bearer <your-credential>"
}
}
}
}標準は読み取り専用です。2026年10月26日に確認した実装では、読み書き認証情報と書き込みツールは開発環境またはcanaryに限定されています。安定版Cloudでの提供を保証するものではありません。利用環境の設定とtools/listで実際の機能を確認してください。
doc_searchワークスペース内ドキュメントのキーワード検索・セマンティック検索。ページまたはキャンバスの位置情報付きで、範囲を絞った抜粋を返します。ファイルやブロブ、Webには一切触れません。
read_documentIDを指定してドキュメント全文を取得。現在のワークスペース権限に準拠します。
create_document有効な環境では、タイトルとMarkdown本文からドキュメントを作成します。データベースブロックや画像の挿入には対応しません。
update_document有効な環境では、構造差分でMarkdown本文を更新します。タイトル変更、データベースブロックや画像の更新には対応しません。
update_document_meta有効な環境ではドキュメントのタイトルを変更します。確認したツールは他のメタデータ項目を公開していません。
認証情報が届く範囲は1ワークスペースだけ。あなたの権限に準拠します。
他に影響を与えず、特定クライアントのアクセスだけを失効できます。
すべての認証情報に作成時点で有効期限を設定します。
旧トークンは最大24時間、元の有効期限が先ならその時点まで有効です。失効操作によりアクセスが早く終了する場合もあります。
MCP対応のノートツールは増えました。違いが出るのは、サーバーが届く範囲・動く場所・管理する主体です。よく聞かれる2つの構成と比べます。
| AFFiNE | Notion MCP | Obsidian | |
|---|---|---|---|
| ファーストパーティ・内蔵 | はいアプリ内蔵のファーストパーティ製サーバー。認証情報はワークスペース設定で発行 | はいNotionがホストする公式リモートサーバー | いいえコミュニティ製プラグインまたはサードパーティ製サーバー |
| セルフホスト可能 | はい同じ公式エンドポイント。自分のインスタンスでAI機能を有効化 | いいえ現行サーバーはホスト型のみ。旧OSS版は非推奨 | 条件付き既定はローカル。リモート化は自作 |
| ホワイトボード検索 | はいEdgelessキャンバスのテキストを索引化し、要素・フレームの位置情報を返す | いいえNotionにネイティブのホワイトボードはない | いいえ.canvasは生JSONとして読めるだけ。検索できる主要サーバーはない |
| デプロイ形態 | Cloud/セルフホストAFFiNE内蔵の公式エンドポイント。セルフホストはAI機能の有効化が必要 | ホスト型のみ現行の公式サーバーはNotionがホスト | ローカルコミュニティ製サーバーがデスクトップのVaultと並走 |
| 料金 | 無料CloudでもAI機能を有効にしたセルフホストでも無料 | コア無料接続アプリ検索や議事録はNotion AIプランが必要 | 無料アプリもコミュニティ製サーバーも無料 |
比較は2026年8月時点で公開ドキュメントに基づきます。
ObsidianのREST APIベースのMCPサーバーはデスクトップアプリの常時起動が必要です。Obsidian公式CLI(2026年)は自動化の公式手段ですが、MCPではありません。
AFFiNEに内蔵された公式のModel Context Protocolエンドポイントです。ClaudeやCursor、ClineなどのAIアシスタントが、標準の認証付きHTTP接続でワークスペースのドキュメントを検索・読み取りできます。認証情報の発行と管理はワークスペース設定から行います。
はい。AFFiNE Cloudでも、AI機能を有効にしたセルフホスト版でも無料で利用できます。接続そのものに追加料金はありません。
できます。doc_searchはページドキュメントとEdgelessホワイトボードの両方を対象にします。キャンバス上のテキストが索引化され、結果にはブロック・要素・フレームの位置情報が付くため、ホワイトボードのどこに答えがあるかまで指し示せます。全文読み取りはページ本文を返し、ホワイトボードの内容は検索経由で見つかります。テキスト専用のMCPサーバーとの大きな違いです。
使えます。公式MCPエンドポイントはセルフホストのAFFiNEでも同じです。エンドポイントは自分のサーバーアドレス上になり、設定手順も同一(設定 → Integrations → MCP Server)。インスタンス側でAI機能を有効にしてください。
標準は読み取り専用です。2026年10月26日に確認した実装では、読み書き認証情報と書き込みツールは開発環境またはcanaryに限定されています。安定版Cloudでの提供を保証するものではありません。利用環境の設定とtools/listで実際の機能を確認してください。
通信方式と認証方式の両方を確認してください。Claude Code・Cursor・ClineはHTTPとBearerヘッダーを利用できます。OAuthログイン専用の接続画面では、この手動発行の認証情報は使えません。stdioブリッジを使えるのはローカルプロセスを起動できるクライアントです。
認証情報が届く範囲は1ワークスペースだけ。あなたの権限に準拠します。 他に影響を与えず、特定クライアントのアクセスだけを失効できます。 すべての認証情報に作成時点で有効期限を設定します。 旧トークンは最大24時間、元の有効期限が先ならその時点まで有効です。失効操作によりアクセスが早く終了する場合もあります。
最終更新: 2026年10月26日