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支持