nestr

@nestr/mcp

Nestr 向けの MCP（Model Context Protocol）サーバーです。Claude などの AI アシスタントをワークスペースに接続します。

これは何ですか？

この MCP サーバーを使うと、AI アシスタントが Nestr のワークスペースを操作できます。

• タスク、プロジェクト、ロールを検索する
• ネストを作成、更新する
• 組織構造（サークル、ロール、アカウンタビリティ）を表示する
• ワークスペースのインサイトと指標を取得する
• コメントを追加して共同作業する

クイックスタート

最も簡単にセットアップするには、mcp.nestr.io にアクセスしてください。Claude Desktop、Claude Code、Cursor 向けの手順を順を追って説明しています。

Claude Desktop

1. Settings → Connectors → Add custom connector に移動します
2. Name に Nestr、Remote MCP URL に https://mcp.nestr.io/mcp を設定します
3. 「Add」をクリックし、続いて「Authenticate」をクリックしてNestrにログインします

Claude Code

claude mcp add nestr --transport http https://mcp.nestr.io/mcp

その後、Claude Code で /mcp を実行し、「Authenticate」をクリックしてログインします。

npm パッケージを使用する（ローカル）

MCP サーバーをローカルで実行する場合は、次の手順に従ってください。

npx @nestr/mcp

AI クライアントを次のように設定します。

{
  "mcpServers": {
    "nestr": {
      "command": "npx",
      "args": ["-y", "@nestr/mcp"],
      "env": {
        "NESTR_API_KEY": "your-api-key-here"
      }
    }
  }
}

API キーを取得するには：

1. Nestr workspace に移動します
2. Settings → Integrations → Workspace API access → Configure をクリックします
3. "New API key" をクリックして、キーをコピーします

使い始める

AI アシスタントに、次のように尋ねてみてください。

• 「アクセスできるワークスペースを教えてください」
• 「マーケティング関連のタスクを検索してください」
• 「『Q1 Planning』という名前の新しいプロジェクトを作成してください」
• 「現在のプロジェクトとそのステータスを教えてください」
• 「カスタマーサポートの担当者は誰ですか？」

利用可能なツール

ワークスペースと検索

ツール	説明
nestr_list_workspaces	アクセス可能なワークスペースを一覧表示する
nestr_get_workspace	ワークスペースの詳細を取得する
nestr_create_workspace	新しいワークスペースを作成する（OAuth のみ）
nestr_search	ネスト（タスク、プロジェクト、ロール）を検索する
nestr_get_me	現在のユーザー ID とワークスペース一覧を取得する

ネスト（タスク、プロジェクト、ロール）

ツール	説明
nestr_get_nest	特定のネストの詳細を取得する（カンマ区切りの ID を指定した一括取得に対応。単一ネストでは provenance／rights／whoCan フラグを使用可能）
nestr_explain_nest	1 つのネストを診断する：フィールド／プロパティの由来（各項目を定義するラベル／サークル）、呼び出し元に適用される権限と拒否の経緯、さらに whoCan を指定した場合は、操作可能なユーザーと問い合わせ先
nestr_get_nest_children	子ネストを取得する
nestr_create_nest	新しいネストを作成する
nestr_update_nest	ネストのプロパティを更新する
nestr_delete_nest	ネストを削除する
nestr_reorder_nest	別のネストに対する位置を指定して、ネストの順序を変更する
nestr_bulk_reorder	複数のネストの順序を一括で変更する
nestr_add_label	ネストにラベルを追加する
nestr_remove_label	ネストからラベルを削除する

繰り返し

ツール	説明
nestr_set_recurrence	タスク、プロジェクト、またはミーティングの繰り返しルールを設定または削除する
nestr_list_occurrences	シリーズの発生分（仮想および実体化済み）を一覧表示する。各項目には、以下のツールで使用する instant が含まれる
nestr_skip_occurrence	シリーズを終了せずに1回分をスキップする。scope: "following" を指定すると、その回とそれ以降のすべての回を削除する
nestr_update_occurrence	1回分を編集する。まだ仮想の場合は、先に実体化する
nestr_delete_series	過去の発生分も含め、シリーズ全体を削除する

コメントとディスカッション

ツール	説明
nestr_add_comment	ネストにコメントを追加する
nestr_get_comments	ネストのコメント／ディスカッションを取得する
nestr_get_nest_activity	ネストとその配下で起きたことを、各変更をデータとして取得する
nestr_update_comment	コメントを更新する
nestr_delete_comment	コメントを削除する

組織構造

ツール	説明
nestr_list_circles	組織のサークルを一覧表示
nestr_get_circle	サークルの詳細を取得
nestr_get_circle_roles	アカウンタビリティとドメインを含む、サークル内の役割を取得
nestr_list_roles	すべての役割を一覧表示
nestr_list_users	ワークスペースのメンバーを一覧表示
nestr_get_user	ユーザーの詳細を取得
nestr_add_workspace_user	ユーザーをワークスペースに追加し、招待メールを送信（API によるプロビジョニングには確認済みドメインが必要ですが、アプリ内での招待には必要ありません）

テンション

ツール	説明
nestr_create_tension	サークルまたは役割にテンションを作成
nestr_get_tension	テンションの詳細を取得
nestr_list_tensions	サークルまたは役割のテンションを一覧表示
nestr_update_tension	テンションを更新
nestr_delete_tension	テンションを削除
nestr_get_tension_parts	テンションの提案パーツを取得
nestr_add_tension_part	提案パーツ（新規または変更されたガバナンス項目）を追加
nestr_modify_tension_part	提案パーツを変更
nestr_remove_tension_part	提案パーツを削除
nestr_get_tension_part_children	提案パーツの子項目（アカウンタビリティ／ドメイン）を取得
nestr_create_tension_part_child	提案パーツに子項目を追加
nestr_update_tension_part_child	提案パーツの子項目を更新
nestr_delete_tension_part_child	提案パーツの子項目を削除
nestr_get_tension_changes	提案パーツによって適用される差分をプレビュー
nestr_get_tension_status	テンションの投票状況を取得
nestr_update_tension_status	投票に提出、または撤回して下書きに戻す

グラフリンク

ツール	説明
nestr_get_graph_links	名前付きの関係（例：ミーティングの議題項目）でリンクされたネストを取得
nestr_add_graph_link	2つのネスト間に双方向リンクを作成
nestr_remove_graph_link	2つのネスト間のリンクを削除

ラベルとプロジェクト

ツール	説明
nestr_list_labels	ワークスペースのラベルを一覧表示
nestr_get_label	ラベルの詳細を取得
nestr_get_projects	ステータス付きでプロジェクトを一覧表示

インサイトとアプリ

ツール	説明
nestr_get_insights	ワークスペースの指標を取得
nestr_get_insight_history	指標の過去の推移データを取得
nestr_get_workspace_apps	有効なアプリ／機能を一覧表示

個人向け（OAuth のみ）

ツール	説明
nestr_get_me	現在のユーザー情報とワークスペースを取得
nestr_list_inbox	ユーザーの受信トレイ項目を一覧表示
nestr_create_inbox_item	項目をすばやく受信トレイに追加
nestr_get_inbox_item	受信トレイ項目の詳細を取得
nestr_update_inbox_item	受信トレイ項目を更新
nestr_reorder_inbox	受信トレイ項目の順序を変更
nestr_list_personal_labels	ユーザーの個人ラベルを一覧表示
nestr_create_personal_label	個人ラベルを作成
nestr_get_daily_plan	今日の予定としてマークされた項目を取得
nestr_add_to_daily_plan	今日の重点項目に追加
nestr_remove_from_daily_plan	今日の重点項目から削除
nestr_list_my_tensions	自分が作成した、または割り当てられたテンションを一覧表示
nestr_list_tensions_awaiting_consent	自分の投票が必要なガバナンス提案を一覧表示

MCP アプリ（インタラクティブ UI）

MCP アプリは、Claude.ai などの対応する MCP クライアントに埋め込めるインタラクティブな UI コンポーネントです。Nestr のデータを扱うための、充実した視覚的なインターフェースを提供します。

完了可能なリスト

リソース URI： ui://nestr/completable-list

タスクやプロジェクトの表示と完了に使える、インタラクティブなリストです。

機能：

• プロジェクトにはボックスアイコン、ToDo にはチェックボックスが表示されます
• 項目にチェックを入れると完了としてマークされます（取り消し線が表示されます）
• タイトルをインライン編集できます（自動保存）
• ドラッグ＆ドロップで並べ替えできます
• コンテキストとして親のパスが表示されます
• Nestr で項目を開くためのクイックリンクが表示されます

使い方： AI アシスタントがタスクやプロジェクトの結果を返すとき、対応クライアントはプレーンテキストの代わりにこのインタラクティブ UI を表示できます。チャット内で項目の完了、タイトルの編集、並べ替えを直接行えます。

認証

OAuth（推奨）

ホスト型サービスの mcp.nestr.io が OAuth を自動的に処理します。サーバーを追加して、ブラウザーから認証するだけです。

OAuth ではユーザーごとの権限が尊重されるため、AI アシスタントは認証済みユーザーがアクセスできる範囲にのみアクセスできます。

API キー

API キーを使うとワークスペース全体にアクセスでき、ローカルの npm パッケージで動作します。上記のクイックスタートを参照してください。

注意： API キーを使用すると、ユーザーの権限に関係なくワークスペース全体にアクセスできます。

環境変数

認証（必須）

変数	説明
NESTR_API_KEY	Nestr API キー（ワークスペース全体へのアクセス）
NESTR_OAUTH_TOKEN	OAuth トークン（ユーザーの権限を尊重）

* ローカルで使用するには、NESTR_API_KEY または NESTR_OAUTH_TOKEN のいずれかが必要です。

設定（任意）

変数	説明	デフォルト
NESTR_API_BASE	API のベース URL	https://app.nestr.io/api

ホスティング／サーバー（HTTP トランスポートのみ）

ホスト型デプロイメントで HTTP サーバーを実行する際に使用します。

変数	説明	デフォルト
PORT	HTTP サーバーのポート	3000
NESTR_OAUTH_CLIENT_ID	ホスト型 OAuth フロー用の OAuth クライアント ID	-
NESTR_OAUTH_CLIENT_SECRET	OAuth クライアントシークレット	-
OAUTH_ENCRYPTION_KEY	保存時に OAuth セッションを暗号化するための 32 バイトの base64 キー	-
GTM_ID	ランディングページ用の Google Tag Manager コンテナ ID	-

アナリティクス（任意）

サーバーサイドのアナリティクス設定：

GA4 Measurement Protocol：

変数	説明
GA4_MEASUREMENT_ID	GA4 Measurement ID（例：G-XXXXXXXXXX）
GA4_API_SECRET	Measurement Protocol API シークレット
GA4_DEBUG	true に設定すると、記録せずにイベントを検証します

注意： GA4 トラッキングには GA4_MEASUREMENT_ID と GA4_API_SECRET の両方が必要です。Measurement ID のみが設定されている場合は、警告がログに記録され、トラッキングは無効になります。

MCPcat（MCP 専用アナリティクス）：

変数	説明
MCPCAT_PROJECT_ID	MCPcat プロジェクト ID（mcpcat.ioから取得）
MCPCAT_ENABLE_REPLAY	セッションリプレイを有効にします（デフォルト：false）

開発

# Clone the repository
git clone https://github.com/nestr-dev/nestr-mcp.git
cd nestr-mcp

# Install dependencies
npm install

# Set your API key
export NESTR_API_KEY=your-api-key

# Run in development mode (stdio)
npm run dev

# Run HTTP server for local testing
npm run dev:http

# Build for production
npm run build

# Test with MCP Inspector
npm run inspect

セキュリティ

SECURITY.mdにポリシー全体が記載されています。脆弱性の報告方法、3 つの認可対象がアクセスできる範囲、このサーバーが保存する情報と保存しない情報について説明しています。要点は以下のとおりです。

• API キーや OAuth トークンをバージョン管理にコミットしないでください
• OAuth トークンはユーザーの権限を尊重するため、推奨されます
• API キーではワークスペース全体にアクセスできます。細かく権限を設定するには OAuth を使用してください
• 読み取りのみが必要な連携には /mcp/readonly を使用してください

認証情報の有効期間とローテーション

OAuth トークンは期限切れになりますが、自動的に更新されます。サーバーはリフレッシュトークンをセッションとともに保持し、有効期限が近づくとアクセストークンを更新するため、長時間稼働するクライアントも再認証せずに使い続けられます。Nestr でセッションを取り消すと、次回の更新が失敗し、その時点でアクセスできなくなります。手動でローテーションする必要はありません。

**API キーは期限切れになりません。**ワークスペースの API キーは、ワークスペース管理者が Nestr の「Settings > Integrations > Workspace API access」で取り消すまで有効です。そのため、ローテーションはサーバーではなく、ご自身で行う必要があります。

• キーにアクセスできる人が離職したときや、設定したスケジュールに従ってローテーションしてください
• 使用されていないキーもワークスペース全体で有効な認証情報であるため、放置せず取り消してください
• キーが漏えいした可能性がある場合は、直ちにローテーションしてください
• 連携機能が読み取りのみを行う場合は、読み取り専用キーを発行し、/mcp/readonly を指定してください

リソース

• セットアップガイド - 手順を追ったセットアップ方法
• Nestr ヘルプセンター
• Nestr API ドキュメント
• Model Context Protocol

ライセンス

MIT - LICENSE を参照してください

サポート

• GitHub の課題
• Nestr サポート