wise-mcp

Wise MCP

向 Claude 或 ChatGPT 询问你的 Wise 资金情况。 为 Wise 余额、银行卡付款、转账和收款人提供最简单、最全面的 MCP 服务，还能准备需要你两次确认的转账。 只需运行一条 npx 命令，即可在本地运行（Claude Desktop、Claude Code、Codex、Cursor……），也可以将其托管为 Claude 和 ChatGPT 的自定义连接器。

“我 9 月在杂货上花了多少钱？” “我的 EUR 罐子里还剩多少？” “显示我今年转给 Mario 的转账记录，以及我获得的汇率。” “给 Mario 转 120 EUR，作为晚餐费用。”

只需提供一次 Wise API 令牌，你的助手就能回答有关所有 Wise 个人和企业资料的问题。它还可以准备转账、新增收款人和取消操作。每项变更都需要你在聊天中明确批准；只有你在 Wise 应用中付款后，转账才会真正执行。

为什么选择它

这是将 Wise 连接到 AI 助手最简单的方式，也是我们所知功能最全面的 Wise MCP 服务（截至 2026 年 10 月）：

• 一个令牌，无需合作伙伴账户。 其他服务需要 Wise 合作伙伴 OAuth 凭据，或者只能提供基本的只读功能。这里无论本地运行还是托管，只需个人 API 令牌即可。
• 真实的消费记录。 活动动态涵盖银行卡付款，并显示清晰的商户名称和金额，也包括个人和企业资料中的转账、货币兑换、返现和罐子。
• 值得信赖的写入操作。 汇率报价、新增收款人、转账和取消操作都采用两步流程，并在聊天中获得批准；转账由你在 Wise 应用中付款。
• 随处可用。 可通过 npx 用于 Claude Desktop、Claude Code、Codex 和 Cursor，也可一键安装 Claude Desktop 扩展，或自托管连接器，供网页和移动端上的 Claude 与 ChatGPT 使用。
• 为真实账户打造。 提供 14 个工具、加密的令牌存储、会话管理、审计日志，以及针对两种运行模式的端到端测试。

选择运行方式

目录

• 为什么选择它
• 选择运行方式
• 工具
• 工作原理
• 安全模型
• 本地运行
• 部署
• 你的服务页面
• 配置
• 开发
• 限制
• 参与贡献
• 许可证

工具

读取

写入：始终分两步

运行时会根据令牌发现个人资料。每个工具都接受可选的 profile：个人资料 ID、personal、business，或个人资料名称的一部分。

工作原理

本地运行时，服务会作为 MCP 客户端的子进程在你的计算机上运行，并从 WISE_API_TOKEN 读取令牌。它不托管在任何地方，也无需登录。

远程运行时，Wise 不向个人提供 OAuth，因此该服务会作为 Claude 和 ChatGPT 的 OAuth 2.1 授权服务；“登录”时，你只需粘贴一次 Wise 个人 API 令牌。

sequenceDiagram
    autonumber
    participant C as Claude / ChatGPT
    participant S as Wise MCP
    participant W as Wise API
    C->>S: Dynamic client registration (trusted redirect hosts only)
    C->>S: /authorize (PKCE)
    S-->>C: Login page: token + "stay connected for"
    Note over C,S: You paste a Wise API token, pick 5 / 15 / 30 / 90 days or until revoked
    S->>W: GET /v1/me
    W-->>S: Wise user id
    S->>S: Allowlist check, token sealed with AES-256-GCM
    S-->>C: Authorization code → access + refresh tokens
    C->>S: MCP tool calls (Bearer, 1 h tokens, rotating refresh)
    S->>W: Reads, and writes only after confirm_action

• 会话时长由每次登录时选择。访问令牌有效期为一小时；刷新令牌每次使用时都会轮换，有效期与会话完全相同。
• **/sessions**会列出 Wise 账户的所有已连接会话，并允许你撤销一个或全部会话。再次粘贴 Wise 令牌即可登录；该令牌仅用于验证你的身份，绝不会被存储。访问权限通过仅限 HTTP 的 Cookie 保持 15 分钟。
• 在 Wise 中撤销也有效：前往 Wise → Settings → API tokens，删除令牌。下次调用会失败并显示明确的错误消息，服务会删除存储的令牌以及使用过该令牌的所有会话。

每次写入操作均需两次确认

prepare_*  ──▶  summary + code (TX-…, RCP-…, CXL-…)  ──▶  you approve in chat  ──▶  confirm_action
                 nothing written to Wise yet              ①                          created in Wise
                                                                                          │
transfers only:                                    you pay it in the Wise app  ◀──────────┘
                                                   ②  money moves only now

• 代码只能使用一次，10 分钟后过期，且只能在生成代码的会话中使用。
• 创建的转账均为未付款状态（incoming_payment_waiting）。无论如何，Wise 不允许个人令牌为 EU/UK 账户中的转账付款，因此最后一步“Pay”始终由你完成。在此之前，你可以使用 prepare_cancel_transfer 或在应用中取消转账。
• 每次准备、确认、丢弃和失败都会追加记录到 audit.log（本地路径为 ~/.wise-mcp/，托管时则写入数据卷）。

安全模型

警告

请勿将 TOKEN_ENCRYPTION_KEY 纳入数据卷的备份。更改该密钥会导致已存储的令牌无法读取：重新连接即可。

本地运行

需要 Node.js 20 或更高版本。请先创建令牌：Wise → Settings → API tokens → Add new token（准备转账和收款人需要 Full access，仅获取答复则选择 Read only）。

Claude Desktop 扩展（一键安装）

从最新版本下载 wise-mcp-<version>.mcpb 并打开。Claude Desktop 会提示你输入令牌（安全存储，不会保存在纯文本配置文件中），并询问是否允许准备转账。

Claude Code

claude mcp add wise -e WISE_API_TOKEN=your-token -- npx -y @blanketbyte/wise-mcp

Codex

将以下内容添加到 ~/.codex/config.toml：

[mcp_servers.wise]
command = "npx"
args = ["-y", "@blanketbyte/wise-mcp"]
env = { WISE_API_TOKEN = "your-token" }

Claude Desktop、Cursor、VS Code 和其他 MCP 客户端

将以下内容添加到客户端的 MCP 配置中（对于 Claude Desktop：Settings → Developer → Edit config）：

{
  "mcpServers": {
    "wise": {
      "command": "npx",
      "args": ["-y", "@blanketbyte/wise-mcp"],
      "env": { "WISE_API_TOKEN": "your-token" }
    }
  }
}

此仓库也是一个 Agent 插件（plugin.json + mcp.json），因此支持该标准的客户端和目录可以直接安装。请在客户端中设置 WISE_API_TOKEN。

可选环境变量：设置 WRITES_ENABLED=false 可启用只读模式，设置 MAX_TRANSFER_AMOUNT 可限制单笔转账金额。运行 npx @blanketbyte/wise-mcp --help 可查看所有选项。

说明

ChatGPT 只能连接远程服务，因此请为 ChatGPT 使用可自托管配置。

部署

容器通过 3000 端口提供纯 HTTP 服务；请将其置于任何可终止 HTTPS 的服务之后。状态数据（加密令牌、会话）存储在 /data 中。

每次发布都会发布预构建镜像：ghcr.io/blanketbyte/wise-mcp:<version>（或 :latest），支持 linux/amd64 和 linux/arm64。只要你的平台支持镜像，就请使用该镜像，而不是从源代码构建。

Dokploy

1. DNS：将一个主机名（例如 wise.example.com）指向你的 Dokploy 服务。
2. 应用程序：Create Service → Application，来源 = 此仓库，分支 main，构建类型为 Dockerfile，上下文为 .。
3. 域名：填写你的主机名，容器端口 3000，开启 HTTPS，证书选择 Let's Encrypt。
4. 卷：挂载一个命名卷到 /data（容器以 uid 1000 运行）。
5. 环境变量：

   PUBLIC_URL=https://wise.example.com
   ALLOWED_WISE_USERS=          # empty on the first deploy, see step 7
   TOKEN_ENCRYPTION_KEY=        # openssl rand -base64 32
   

6. 部署，然后访问 https://wise.example.com/health 检查。
7. 查找你的 Wise 用户 ID：先从 Claude 连接一次。Not allowed 页面会显示你的 ID：设置 ALLOWED_WISE_USERS=<id>，重新部署并再次连接。

Easypanel

1. DNS：将一个主机名（例如 wise.example.com）指向你的 Easypanel 服务。
2. 服务：在一个项目中，选择 + Service → App，将其命名为 wise-mcp。
3. 来源：选择 GitHub，填写此仓库的所有者/仓库，分支 main，构建路径 /。（或者选择 Git 并填写仓库 URL。）
4. 构建：选择 Dockerfile，文件为 Dockerfile。
5. 环境变量：

   PUBLIC_URL=https://wise.example.com
   ALLOWED_WISE_USERS=          # empty on the first deploy, see step 9
   TOKEN_ENCRYPTION_KEY=        # openssl rand -base64 32
   

6. 域名：添加 wise.example.com，开启 HTTPS，端口 3000。Easypanel 会签发 Let's Encrypt 证书。
7. 挂载：添加一个名为 data、挂载路径为 /data 的卷挂载。如果没有此挂载，每次重新部署都会丢失会话和令牌。
8. 部署，然后访问 https://wise.example.com/health 检查。
9. 查找你的 Wise 用户 ID：从 Claude 或 ChatGPT 连接一次。Not allowed 页面会显示你的 ID：设置 ALLOWED_WISE_USERS=<id>，再次部署并重新连接。

若要在每次推送时自动重新部署，请在服务上启用 Auto Deploy（这会添加一个 GitHub webhook）。

Docker Compose

cp .env.example .env            # fill it in
mkdir -p data && sudo chown 1000:1000 data
docker compose up -d --build    # listens on 127.0.0.1:3000

连接 Claude

1. 在 Wise 中：选择 Settings → API tokens → Add new token。选择 Full access 以准备转账和收款人，或者如果你只想获取解答，则选择 Read only。
2. 在 Claude 中：选择 Settings → Connectors → Add custom connector：

   https://wise.example.com/mcp
   

3. 粘贴令牌，选择保持连接的时长，完成。

ChatGPT：选择 Settings → Apps & Connectors，开启 Developer mode（在 Advanced 下），然后使用相同的 /mcp 地址和 OAuth 身份验证创建一个连接器。同一个登录页面会打开。

你的服务页面

部署后，你的服务有三个可在浏览器中打开的页面。请将 wise.example.com 替换为你自己的地址。

常见情况

• “我想断开某台设备或某个应用。” 打开管理会话，点击对应会话旁的 Revoke。
• “我觉得令牌泄露了。” 在 Wise → Settings → API tokens 中删除该令牌。所有使用它的会话都会立即停止工作，服务也会删除其副本。然后使用新令牌重新连接。
• “Claude 或 ChatGPT 提示我重新连接。” 你的会话已过期或被撤销。移除并重新添加连接器；此时会打开登录页面。
• “登录页面显示 Not allowed。” 你的 Wise 账户不在此服务的允许列表中。页面会显示你的 Wise 用户 ID：将其添加到 ALLOWED_WISE_USERS 并重新部署。

此外，还可通过 https://wise.example.com/health 进行监控；服务运行时，该地址会返回 {"ok":true}。

配置

启动时，服务会记录允许的用户和加密密钥的简短 SHA-256 指纹，让你在不泄露密钥的情况下确认部署的是哪个密钥。

开发

npm install
npm run dev         # remote server with tsx watch (needs the remote env vars)
npm test            # typecheck + both end-to-end suites
npm run e2e         # remote server against a local mock of the Wise API
npm run e2e:stdio   # local mode: spawns the CLI like an MCP client would
npm run mcpb        # builds release/wise-mcp-<version>.mcpb

远程端到端测试会在模拟 Wise API 旁启动服务，并完整模拟 Claude 执行的所有操作：客户端注册、PKCE 登录、允许列表、会话时长、令牌刷新轮换、静态加密、每个工具（金额解析、分页、筛选器）、两步写入（一次性代码、跨会话隔离、路由要求、取消、审计日志、只读令牌）、/sessions，以及在 Wise 中撤销令牌。stdio 测试套件覆盖 CLI、令牌错误、通过 stdio 使用的每个工具、两步写入、审计日志和只读模式。

发布

推送一个与 package.json 匹配的标签（例如 v1.1.0）。发布工作流会运行测试，通过来源证明将 @blanketbyte/wise-mcp 发布到 npm（通过 GitHub OIDC 进行可信发布，不在任何位置存储 npm 令牌），根据 server.json 将其列入 官方 MCP Registry，将 .mcpb 附加到 GitHub 发布，并将 Docker 镜像推送到 ghcr.io/blanketbyte/wise-mcp。首次发布前，请从 package.json 中移除 "private": true。

src/
  cli.ts               Entry point: `wise-mcp` (stdio) or `wise-mcp serve` (remote)
  stdio.ts             Local mode over stdin/stdout
  index.ts             Remote server: icons, OAuth routes, /login, /sessions, /mcp
  config.ts            Environment validation (shared and remote-only settings)
  meta.ts              Version, paths, links
  crypto.ts            AES-256-GCM sealing, cookie signing
  tools.ts             MCP tools (read + two-step write)
  pending.ts           Prepared actions and one-time confirmation codes
  wise/client.ts       Wise API client (retries, idempotent transfers, revocation detection)
  wise/service.ts      Profiles, balances, activities, transfers, recipients, rates
  wise/connections.ts  Encrypted per-token connections
  auth/provider.ts     OAuth 2.1 provider for Claude, token-paste login
  auth/store.ts        Clients, sessions, hashed tokens
  auth/pages.ts        Login, /sessions and message pages
public/                Logo, icons, favicon
mcpb/manifest.json     Claude Desktop extension manifest
scripts/e2e.ts         Remote end-to-end test with a mock Wise API
scripts/e2e-stdio.ts   Local (stdio) end-to-end test
scripts/build-mcpb.sh  Builds the .mcpb bundle
.github/workflows/     CI, and release to npm + GitHub

限制

个人 API 令牌无法使用所有 Wise 端点。尤其是对于 EU/UK 账户，PSD2 规则会阻止访问余额对账单（因此没有每笔交易的余额）和卡片列表。活动动态包含银行卡付款，因此日常消费相关问题都能正常处理。

在写入方面，个人令牌无法为 EU/UK 账户充值转账（你需要在 Wise 应用中付款，而本服务本来也依赖这一操作），并且对于设置了付款审批规则的企业账户，Wise 会拒绝 API 转账。

贡献

欢迎提交 Issue 和 Pull Request；请参阅 CONTRIBUTING.md。请按照 SECURITY.md 中的说明，私下报告安全问题。

许可证

MIT © BlanketByte

_{由 BlanketByte 制作。独立项目，与 Wise 无关联，也未获 Wise 认可。
Wise 和 Wise 旗帜是 Wise Payments Limited 的商标；旗帜未经修改，仅用于表示兼容性。}