wise-mcp

Wise MCP

Wise のお金について Claude や ChatGPT に質問できます。 Wise の残高、カード決済、送金、受取人に対応し、さらに二度の承認を経て送金を準備できる、最もシンプルで機能が充実した MCP サーバーです。 1 つの npx コマンドでローカル実行するか（Claude Desktop、Claude Code、Codex、Cursor など）、Claude や ChatGPT 用のカスタムコネクターとしてホストできます。

「9 月に食料品にいくら使いましたか？」 「EUR で、Jars にいくら残っていますか？」 「今年 Mario に送金した履歴と、そのときの為替レートを見せてください。」 「夕食代として Mario に 120 EUR 送金してください。」

Wise API トークンを一度設定すれば、アシスタントは個人用とビジネス用のすべての Wise プロフィールについて、こうした質問に回答できます。送金、新しい受取人の登録、キャンセルの準備もできます。変更にはチャットでの明示的な承認が必要で、送金が実行されるのはWise アプリでお客様がお支払いした後だけです。

これを選ぶ理由

Wise を AI アシスタントに接続する最もシンプルな方法であり、私たちが知る限り最も機能が充実した Wise MCP サーバーです（2026 年 10 月時点）。

• トークン 1 つで、パートナーアカウントは不要です。 ほかのサーバーでは Wise パートナーの OAuth 認証情報が必要だったり、基本的な読み取り専用機能に限られたりします。こちらは、ローカルでもホスト環境でも、個人用 API トークンだけで利用できます。
• 実際の支出を確認できます。 アクティビティフィードには、分かりやすい加盟店名と金額を含むカード決済のほか、個人用とビジネス用のプロフィールにわたる送金、両替、キャッシュバック、Jars が表示されます。
• 安心して利用できる書き込み機能です。 見積もり、新しい受取人、送金、キャンセルはすべて 2 段階で、チャット内で承認します。送金は Wise アプリでお客様がお支払いします。
• どこでも利用できます。 Claude Desktop、Claude Code、Codex、Cursor 用の npx、ワンクリックでインストールできる Claude Desktop 拡張機能、またはウェブやモバイルで Claude と ChatGPT に接続するセルフホスト可能なコネクターを利用できます。
• 実際のアカウント向けに構築されています。 14 個のツール、暗号化されたトークンストレージ、セッション管理、監査ログ、両方のモードを対象とするエンドツーエンドテストを備えています。

実行方法を選択する

目次

• これを選ぶ理由
• 実行方法を選択する
• ツール
• 仕組み
• セキュリティモデル
• ローカルで実行
• デプロイ
• サーバーのページ
• 設定
• 開発
• 制限事項
• コントリビューション
• ライセンス

ツール

読み取り

書き込み：必ず2段階

プロフィールは実行時にトークンから検出されます。すべてのツールで省略可能な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

• セッションの長さはログインのたびに選択します。アクセストークンの有効期間は1時間です。リフレッシュトークンは使用のたびにローテーションされ、セッションとまったく同じ期間だけ有効です。
• **/sessions**では、Wiseアカウントに接続されているすべてのセッションを一覧表示し、1つまたはすべてを取り消せます。Wiseトークンをもう一度貼り付けてサインインします。このトークンは本人確認にのみ使われ、保存されません。アクセスにはHTTP専用Cookieが使われ、有効期間は15分です。
• Wiseでの取り消しも有効です：Wiseの「Settings」→「API tokens」でトークンを削除します。次の呼び出しは明確なメッセージとともに失敗し、サーバーは保存済みのトークンと、それを使用したすべてのセッションを削除します。

書き込みのたびに2回確認

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

• コードは1回限りで、有効期限は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（送金と受取人の準備にはフルアクセス、回答のみの場合は読み取り専用）。

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" }
    }
  }
}

このリポジトリはエージェントプラグイン（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ウェブフックが追加されます）。

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 認証を使ってコネクターを Create します。同じログインページが開きます。

サーバーのページ

デプロイ後、ブラウザーで開けるページがサーバーに3つあります。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 ログイン、許可リスト、セッションの有効期間、リフレッシュトークンのローテーション、保存時の暗号化、すべてのツール（金額の解析、ページネーション、フィルター）、2 段階の書き込み（単回使用コード、セッション間の分離、ルート要件、キャンセル、監査ログ、読み取り専用トークン）、/sessions、Wise での取り消し）を実行します。stdio テストスイートでは、CLI、トークンエラー、stdio 経由のすべてのツール、2 段階の書き込み、監査ログ、読み取り専用モードをテストします。

リリース

package.json に一致するタグ（例：v1.1.0）をプッシュします。リリースワークフローではテストを実行し、provenance 付きで @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 やプルリクエストを歓迎します。CONTRIBUTING.md をご覧ください。セキュリティ上の問題は、SECURITY.md に記載の方法で非公開に報告してください。

ライセンス

MIT © BlanketByte

_{BlanketByte が制作。独立したプロジェクトであり、Wise との提携や Wise による推奨を受けていません。
Wise および Wise の旗は Wise Payments Limited の商標です。旗は互換性を示すため、改変せずに表示しています。}