Nestr MCP

🚀 @nestr/mcp

Nestr 用の MCP (Model Context Protocol) サーバーです。Claude などの AI アシスタントをあなたのワークスペースに接続できます。

🚀 クイックスタート

クイックスタートガイドを参照して、Claude Desktop、Claude Code、Cursor のステップバイステップのセットアップ手順を確認してください。

Claude Desktop

1. 設定 → コネクタ → カスタムコネクタの追加 を選択します。
2. 名前 を Nestr、リモート MCP URL を https://mcp.nestr.io/mcp に設定します。
3. 「追加」をクリックし、次に「認証」をクリックして Nestr でログインします。

Claude Code

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

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

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 ワークスペースにアクセスします。
2. 設定 → 統合 → ワークスペース API アクセス → 設定 をクリックします。
3. 「新しい API キー」 をクリックし、キーをコピーします。

✨ 主な機能

この MCP サーバーにより、AI アシスタントが Nestr ワークスペースと対話できます。

• タスク、プロジェクト、役割を検索する
• ネスト（タスク、プロジェクト、役割）を作成および更新する
• 組織構造（サークル、役割、責任範囲）を表示する
• ワークスペースの洞察とメトリクスを取得する
• コメントを追加し、共同作業を行う

💻 使用例

AI アシスタントに以下のような質問をしてみましょう。

• "アクセス可能なワークスペースはどれですか？"
• "マーケティングに関連するタスクを検索してください。"
• "「Q1 企画」という名前の新しいプロジェクトを作成してください。"
• "現在のプロジェクトとその状態は何ですか？"
• "カスタマーサポートの担当者は誰ですか？"

📚 詳細ドキュメント

利用可能なツール

ワークスペースと検索

ネスト（タスク、プロジェクト、役割）

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

組織構造

ラベルとプロジェクト

洞察とアプリ

個人用（OAuth のみ）

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_OAUTH_TOKEN のいずれかが必要です。

設定（オプション）

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

これらは、ホストされたデプロイメント用の HTTP サーバーを実行するときに使用されます。

分析（オプション）

サーバー側の分析オプションです。

GA4 測定プロトコル:

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

MCPcat（MCP 固有の分析）:

開発

# リポジトリをクローンする
git clone https://github.com/nestr-dev/nestr-mcp.git
cd nestr-mcp

# 依存関係をインストールする
npm install

# API キーを設定する
export NESTR_API_KEY=your-api-key

# 開発モードで実行する（標準入出力）
npm run dev

# ローカルテスト用の HTTP サーバーを実行する
npm run dev:http

# 本番用にビルドする
npm run build

# MCP インスペクターでテストする
npm run inspect

セキュリティ

• API キーや OAuth トークンをバージョン管理システムにコミットしないでください。
• OAuth トークンはユーザー権限を尊重するため、推奨されます。
• API キーは完全なワークスペースアクセスを提供するため、細かい権限管理には OAuth を使用してください。
• 資格情報が漏洩した疑いがある場合は、ローテーションしてください。

📄 ライセンス

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

サポート

• GitHub の問題
• Nestr サポート