Nestr MCP

🚀 @nestr/mcp

Nestr的MCP（模型上下文協議）服務器，可將Claude等AI助手連接到你的工作區。

🚀 快速開始

訪問 mcp.nestr.io ，這裡有針對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助手詢問以下問題：

• "我可以訪問哪些工作區？"
• "搜索與營銷相關的任務"
• "創建一個名為'第一季度規劃'的新項目"
• "我當前的項目有哪些，它們的狀態如何？"
• "誰負責客戶支持？"

📦 安裝指南

本地運行

npx @nestr/mcp

📚 詳細文檔

可用工具

工作區與搜索

嵌套項（任務、項目、角色）

評論與討論

組織結構

標籤與項目

洞察與應用

個人（僅支持OAuth）

MCP應用（交互式UI）

MCP應用是交互式UI組件，可以嵌入支持它們的MCP客戶端（如Claude.ai）中。它們為處理Nestr數據提供了豐富的可視化界面。

可完成列表

資源URI：ui://nestr/completable-list

用於查看和完成任務及項目的交互式列表。

特性：

• 項目顯示方框圖標，待辦事項顯示覆選框
• 勾選項目以標記為已完成（加刪除線）
• 內聯編輯標題（自動保存）
• 拖放重新排序
• 顯示父路徑以提供上下文
• 快速鏈接以在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以獲得更精細的權限控制。
• 如果你懷疑憑據已洩露，請輪換它們。

資源

• 設置指南 - 分步設置說明
• Nestr幫助中心
• Nestr API文檔
• 模型上下文協議

📄 許可證

本項目採用MIT許可證，請參閱 LICENSE 瞭解詳細信息。

支持

• GitHub問題
• Nestr支持