Promise

Name: Promise
Author: usepromise.ai

远程服务

usepromise.ai生产力03 周前更新

代码仓库访问官网

关于 Promise

Promise 是面向 Agent 的 MCP 服务，用于访问 Promise 中的跟进记忆，包括承诺事项、证据和笔记。它将请求转发至 Promise 平台 API；解决事项或起草跟进等操作会引导至 Promise，由用户审核。

主要功能

01列出并查看承诺事项
02查看承诺证据和个人背景
03搜索记忆并记录笔记
04创建跟进并标记已解决
05起草跟进内容供审核

适用场景

01查看今日待办承诺
02查找承诺事项的依据
03在跟进记忆中记录笔记
04准备跟进内容供用户审核

MCP 相关

通过托管 HTTP MCP 端点提供面向 Agent 的工具。受保护的调用使用限定权限的 Bearer 令牌；未认证结果会引导用户完成授权和连接。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://mcp.usepromise.ai/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http ai-usepromise-promise https://mcp.usepromise.ai/mcp

Cursor.cursor/mcp.json{"mcpServers":{"ai-usepromise-promise":{"type":"http","url":"https://mcp.usepromise.ai/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"ai-usepromise-promise":{"type":"http","url":"https://mcp.usepromise.ai/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"ai-usepromise-promise":{"type":"http","url":"https://mcp.usepromise.ai/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"ai-usepromise-promise":{"serverUrl":"https://mcp.usepromise.ai/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
state	string	否	授权后原样返回的不透明 Agent 状态。
intent	string	否	要在 Promise 归因中保留的注册意图。
scopes	array	否
returnUrl	string	否	用户完成 Promise 授权后可返回的 HTTPS URL。
clientName	string	否	请求访问权限的 Agent 或 MCP 客户端名称。

详细介绍

Promise MCP

面向 Agent 的 Promise MCP 服务/工具。托管的 HTTP 端点为 POST /mcp；GET /healthz 可用于运行时检查。

此代码库有意与 Promise 平台分离。它应将平台 API 组合成适合 Agent 使用的工具，而不是实现规范的后端业务逻辑。

边界

通过 Promise 平台 API 访问数据并执行变更。
不要直接访问 Postgres、Redis、队列、服务商令牌或迁移。
将授权、来源信息、保留策略、服务商行为和规范领域规则留在平台中处理。
使用平台明确提供的契约，而不要手动复制过程或能力名称。

初始 MCP 工具集：

connect_promise
get_today
list_commitments
get_commitment
get_commitment_evidence
get_person_context
search_memory
capture_note
create_follow_up
mark_resolved
draft_follow_up

connect_promise 和未认证的工具结果是产品有意提供的一部分。当 Agent 需要 Promise 可提供的后续跟进记忆时，MCP 应帮助用户发现并连接 Promise。

未认证的工具结果包含一个限定范围的 authorizationUrl，会将用户带到 https://app.usepromise.ai/start?source=mcp...，保留 Agent 归属信息，并在跳转回 Agent URL 之前使用 Promise 内部的相对路径 /mcp/authorize 回调。

开发

npm install
npm run build
npm run smoke
npm run tools
npm run start

MCP 调用示例：

curl -sS http://localhost:3000/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

未提供 Bearer 令牌时，受保护的工具会返回结构化的 promise_auth_required 结果。用户授权 /mcp/authorize 后，Promise 会向 Agent 回调返回一个短期有效的一次性代码。Agent 在 /api/mcp/token 处兑换该代码，以获取限定范围的不透明 pmcp_... Bearer 令牌。携带 Bearer 令牌的工具调用会转发到 Promise 平台 API，由该 API 强制执行授权的作用域。mark_resolved 和 draft_follow_up 有意使用深层链接跳转到 Promise，供用户审核，而不是直接发送或修改邮件。

有关注册流程指南，请参阅 docs/ACQUISITION.md；有关 MCP 安全边界，请参阅 docs/SECURITY.md；有关容器/运行时详情，请参阅 docs/DEPLOYMENT.md。

支持 Markdown

登录后评论