niftypm

Nifty MCP Server

Nifty 的官方 Model Context Protocol 服务。它让 AI Agent 能够访问你的 Nifty 工作区：任务、项目、消息、文档、文件等。它适用于 Claude、ChatGPT、Cursor，以及任何支持远程 MCP 服务的客户端。

这是一个托管式（远程）服务，无需安装或运行任何内容。本仓库包含其公开说明、注册表元数据（server.json）和连接指南。服务本身由 Nifty 运营。

连接

端点： https://mcp.niftypm.com/mcp（Streamable HTTP）

最简单的方式： 在 Nifty 中打开 Settings → MCP（app.nifty.pm/settings/mcp）。向导涵盖 Claude、Claude Code、ChatGPT 和 Cursor，并提供可直接粘贴的配置或 OAuth 连接器流程。

手动连接： 将端点添加为远程 MCP 服务，并以 Bearer 令牌的形式发送 Nifty Personal Access Token。可在 app.nifty.pm/settings/personal-access-tokens 创建：

Authorization: Bearer <your Nifty personal access token>

Claude、ChatGPT 和 Microsoft 365 Copilot 也可以通过 Nifty 的连接器使用你的 Nifty 帐户登录，该连接器可从 Settings → MCP 启动。其他客户端需要使用令牌。

本仓库中的插件和扩展清单会从 NIFTY_PAT 环境变量读取令牌（Gemini CLI 会在安装扩展时提示输入令牌）：

export NIFTY_PAT=<your Nifty personal access token>

Claude Code 示例：

claude mcp add --transport http nifty https://mcp.niftypm.com/mcp --header "Authorization: Bearer $NIFTY_PAT"

安装为插件或扩展

本仓库也可作为插件，供从 Git 仓库安装的客户端使用：

客户端	安装
Claude Code	/plugin marketplace add Nifty-Technologies-Inc/nifty-mcp，然后运行 /plugin install nifty@nifty
Gemini CLI	gemini extensions install https://github.com/Nifty-Technologies-Inc/nifty-mcp
Cursor	将 mcp.json 复制到 .cursor/mcp.json，或在 Settings → MCP 中添加端点
Cline	请参阅 llms-install.md

仅支持 stdio 的客户端

使用 mcp-remote 建立桥接。将整个标头值放入 env，避免在 args 中出现空格：

{
  "mcpServers": {
    "nifty": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.niftypm.com/mcp", "--header", "Authorization:${NIFTY_AUTH}"],
      "env": { "NIFTY_AUTH": "Bearer <your Nifty personal access token>" }
    }
  }
}

示例提示词

• “Website Redesign 项目中有哪些逾期任务？按负责人分组。”
• “在 Marketing 中创建一个名为 ‘Draft Q4 launch post’ 的任务，分配给我，截止日期设为周五。”
• “总结本周 Product 讨论中的消息。”
• “将 Mobile App 项目中所有带有 ‘bug’ 标签的任务移至 In Review 状态。”
• “Client Onboarding 项目中哪些里程碑有风险？”
• “查找有关我们发布检查清单的文档，并列出其中尚未完成的事项。”

工具

工具按领域分组，每个领域都有三种动词：_query（浏览、筛选、分页、全文搜索）、_mutate（创建、更新、关联关系、批量写入）和 _destroy（删除）。

工具	功能
tasks_query	查找任务、检查清单和提醒
tasks_mutate	创建或更新任务、检查清单和提醒
tasks_destroy	删除任务、检查清单和提醒
planning_query	查找项目、项目组合、里程碑和目标
planning_mutate	创建或更新项目、项目组合、里程碑和目标
planning_destroy	删除项目、项目组合、里程碑和目标
communication_query	查找聊天、消息和签到
communication_mutate	创建或更新聊天、消息和签到
communication_destroy	删除聊天、消息和签到
knowledge_query	查找文档和文件
knowledge_mutate	创建或更新文档和文件
knowledge_destroy	删除文档和文件
people_query	查找成员
people_mutate	邀请或更新成员
people_destroy	移除成员
reporting_query	查找工时记录、图表和项目动态
reporting_mutate	创建或更新工时记录和图表
reporting_destroy	删除工时记录和图表
admin_query	查找标签、角色、收藏项和自定义字段
admin_mutate	创建或更新标签、角色和收藏项
admin_destroy	删除标签、角色和收藏项

完整的机器可读列表（包含说明和输入架构）发布在 mcp.niftypm.com/.well-known/mcp/server-card.json。

每次调用都会以已登录用户（或令牌的 Agent 身份）及其 Nifty 权限运行。服务只能看到你能看到的内容。

提示词

• plan_my_week：根据你未完成且即将到期的任务，拟定一份切实可行的每周逐日计划。
• project_status_digest：总结项目状态，包括进度、逾期事项、近期交付和主要风险。
• triage_overdue_tasks：梳理你自己的逾期任务，并决定哪些要重新安排、重新分配、放弃或立即处理。
• standup_digest：根据你的任务，拟定一份包含“昨天／今天／阻碍事项”的站会更新。
• meeting_notes_to_tasks：将会议记录转换为项目中的规范任务，供你审核。
• find_and_update：查找符合描述的任务并应用更改——先进行审核。

文档和支持

• 文档：Nifty MCP Server 使用指南
• 支持：nifty.pm

许可证

本仓库内容采用 MIT 许可证（参见 LICENSE）。托管服务受 Nifty 服务条款约束。