CDF Finance MCP

Name: CDF Finance MCP
Author: VessellTech

作者：VessellTechバージョン 0.1.8i★ –iクラウドで動く

レジストリ名io.github.VessellTech/cdf.mcp

インストール

概要

作者による説明（英語の原文）

Consulte contas, cartões, transações e orçamentos da sua conta financeira Vessell.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: クラウドで動く
トランスポート: Streamable HTTP
カテゴリ: 会計・財務・税務

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
作者のサーバーで動きます。あなたが頼んだ内容は、作者のサーバーを通ります。
レジストリには、入力が必要なキーは載っていません。

必要なもの

クラウドで動くインストール不要。インターネット経由でつながります

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

ウェブ、デスクトップ、モバイルのClaudeで使えます：

Settings → Connectors を開く
Add custom connector を押す
下のアドレスを貼り付けて Add を押す
サインインを求められたら、作者のサービスにサインインする

https://mcp.cdf.finance/mcp

ターミナルでこれを実行します

claude mcp add --transport http cdf https://mcp.cdf.finance/mcp

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "cdf": {
      "url": "https://mcp.cdf.finance/mcp"
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "cdf": {
      "type": "http",
      "url": "https://mcp.cdf.finance/mcp"
    }
  }
}

ChatGPTがつなげるのは、インターネット上のサーバーだけです：

ウェブ版のChatGPTを開き → Settings → Connectors (Apps)
Create または Add を押す（プランによっては、先に Advanced で Developer mode をオンにする必要があります）
下のアドレスを貼り付け、名前を付けて保存する
サインインを求められたら、作者のサービスにサインインする

https://mcp.cdf.finance/mcp

メニューの名前は、プランや時期によって少し違うことがあります。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

このサーバーのツール一覧はまだ読み取っていません。エンドポイントは順番にチェックしています。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月7日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント VessellTech で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
… 未チェック
エンドポイントが応答する
まだチェックしていません。エンドポイントは順番にチェックしています
… 未チェック
OAuthでサインイン
まだチェックしていません。エンドポイントは順番にチェックしています
… 未チェック
ツールの説明に隠れた指示がない
まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります

会計・財務・税務のほかのサーバーとの比較i

このカテゴリのほかの1726件のうち0%よりスターが多い
このカテゴリのほかの1726件のうち41%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの1726件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

CDF Finance MCPは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか？

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.1.8）がレジストリに届いたのは2 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ（開発者モードのChatGPTなど）でも使えます。

代わりに使えるものは？

同じカテゴリには：Finance Toolkit, SolidInvoice, Korea Tax Calculator

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Finance Toolkit

作者：JerBouma

500+ transparent financial methods calculated from raw statements, not third-party endpoints.

パソコンでもクラウドでも★ 5,496MIT今日更新

インストール

SolidInvoice

作者：SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

クラウドで動く★ 981MIT7 日前更新

インストール

Korea Tax Calculator

作者：UpstageAI

Korean tax calculation and tax-audit judgment MCP: 96 tools with statutory citations.

パソコンで動く★ 97MIT昨日更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

CDF Finance MCP

Conecte Claude, ChatGPT e qualquer client MCP (OAuth 2.1) à sua conta CDF Finance — consulte e registre sua vida financeira por linguagem natural.

Remoto: https://mcp.cdf.finance/mcp (Streamable HTTP) · Website: https://cdf.finance/mcp · Status: https://status.cdf.finance · Suporte: support@cdf.finance

O que é

MCP server stateless e isolado para o CDF Finance — app de controle financeiro pessoal (contas, cartões, transações, faturas, orçamentos, metas, dívidas, investimentos e insights).

Para usuários: pergunte ao Claude/ChatGPT sobre seu dinheiro e registre lançamentos sem abrir o app.
Para desenvolvedores/revisores: código auditável, sem dependência do backend-husk — só HTTP sobre a API pública que o app mobile já usa.

Source-available sob BUSL-1.1: pode auditar, usar com o CDF Finance, contribuir. Uso em produção como produto concorrente exige licença comercial. Vira Apache-2.0 em 2030-09-01.

Exemplos

Você diz	O que acontece
"Quanto sobrou do meu salário esse mês?"	`current_month_spending` + `categories_insights`
"Minha próxima fatura vai caber no orçamento?"	`list_pending_invoices` + `budget_comparison`
"Lança um Uber de R$ 27,50 no Nubank como Transporte"	`list_accounts` + `list_categories` + `create_transaction`

English: *"How much is left of my salary?" / "Will my next bill fit the budget?" / "Log an Uber ride of R$27.50 on Nubank as Transportation."*

Arquitetura

Isolamento total do backend-husk — este serviço não importa código do backend.

Claude / ChatGPT (MCP client)

│ OAuth 2.1 — DCR + PKCE (S256) ▼ ┌───────────────────────────────┐ │ cdf-mcp-server (este repo) │ Postgres isolado (Railway) │ • Authorization Server │ ├─ oauth_clients / oauth_codes │ • Resource Server (/mcp) │ ├─ oauth_tokens (hash SHA-256) │ • Catálogo declarativo │ └─ sessions (JWT mobile criptografado │ ~50 tools → REST │ AES-256-GCM) └───────────────┬───────────────┘ │ HTTPS — Bearer ▼ backend-husk (api.vessell.app) API pública — mesmo contrato do app mobile

Fluxo de login:

Client faz Dynamic Client Registration em /register.
Usuário autoriza em /authorize (form server-rendered, sem terceiros) → POST /api/mobile/auth/login com device_id=mcp- , platform=mcp.
access/refresh do backend ficam criptografados em sessions; client MCP recebe apenas token opaco (oauth_tokens).
Cada tool renova o access_token via refresh automaticamente (getValidAccessToken).
Sessão aparece como device em GET /api/mobile/devices — revogável em DELETE /api/mobile/devices/:id.

Por que isolado (README original): sem dependência circular, deploy/escala independentes (Railway vs Coolify no backend) e imune a troca de linguagem do backend — só fala HTTP.

Tools

Catálogo 100% declarativo em src/tools/catalog/ — cada tool é { name, method, path, input(zod) } executada por src/tools/register.ts. Nova rota no backend = nova entrada, sem handler.

Domínio	Tools (exemplos)
User	`get_profile`, `update_profile`
Accounts / Cards	`list_accounts`, `create_account`, `list_cards`, `current_invoice`
Categories / Cost Centers	`list_categories`, `create_category`, `list_cost_centers`
Transactions	`list_transactions`, `create_transaction`, `confirm_pending_transaction`, `upcoming_transactions`
Recurring / Invoices	`list_recurring_transactions`, `list_invoices`, `pay_invoice`
Goals / Budgets / Debts	`list_goals`, `budget_comparison`, `create_debt`, `debt_payoff_simulation`
Equities / Investments	`list_equities`, `add_equity_valuation`, `investments_workspace`
Insights / Analytics	`cashflow_forecast`, `spending_projection`, `networth_projection`, `categories_insights`, `behavior_insights`, `can_afford`, `analytics_history`
Tags	`list_tags`, `create_tag`

Fora de escopo de propósito (igual ao backend): admin, Stripe/pagamentos, webhooks, S3/anexos, /api/ai/*.

Modo somente leitura: MCP_TOOLS_MODE=readonly expõe só readOnly:true — ideal para diretórios curados.

Quick start

cp .env.example .env   # preencha DATABASE_URL, TOKEN_ENCRYPTION_KEY, SESSION_SECRET

npm install npm run db:migrate npm run dev # http://localhost:8090

Teste com MCP Inspector:

npx @modelcontextprotocol/inspector

Transport: Streamable HTTP → http://localhost:8090/mcp

Variáveis de ambiente

Var	Obrigatória	Descrição
`PUBLIC_URL`	sim	URL pública deste serviço (entra nos metadados OAuth). Gere o domínio antes do primeiro deploy
`PORT`	não	default `8090`
`BACKEND_API_URL`	sim	`https://api.vessell.app` (ou staging)
`DATABASE_URL`	sim	Postgres isolado deste serviço
`TOKEN_ENCRYPTION_KEY`	sim	32 bytes base64: `node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"`
`SESSION_SECRET`	sim	string longa aleatória p/ cookies `/authorize`
`MCP_SERVICE_TOKEN`	não	segredo serviço-a-serviço (`backend-husk → MCP` via `X-CDF-User-Token`). Se ausente, só OAuth
`MCP_TOOLS_MODE`	não	`full` (default) ou `readonly`
`OPENAI_APPS_CHALLENGE_TOKEN`	não	verificação de domínio OpenAI
`ALLOWED_ORIGINS`	não	CORS do `/authorize` — default `https://claude.ai,https://chatgpt.com`

Ver .env.example comentado.

Deploy (Railway)

railway init ou conecte o repo no dashboard.
Adicione addon Postgres (injeta DATABASE_URL).
Configure envs acima — gere domínio em Settings → Networking primeiro.
Deploy: Dockerfile → node dist/index.js (railway.json já configurado).
Migration: railway run npm run db:migrate.
No Claude.ai/ChatGPT aponte o connector para https:// .up.railway.app/mcp — DCR/OAuth é automático.

Segurança

PKCE S256 obrigatório em todo authorization_code.
Tokens opacos — só SHA-256 persiste (oauth_tokens), bruto é entregue uma vez.
JWT mobile criptografado AES-256-GCM em sessions — nunca exposto ao client (src/crypto.ts, src/mcp/http.ts).
Device isolado — cada sessão mcp- (src/backend/client.ts:45) revogável sem afetar outros logins.
Sanitização — redactLargeInlineData + redactFields (src/tools/register.ts:19) evita vazamento de data: URI e campos sensíveis pro LLM.

Reporte vulnerabilidades em SECURITY.md — não abra issue pública: support@cdf.finance [SECURITY].

Conformidade — Diretório Anthropic (Seção 4.A)

Este conector não transfere dinheiro/cripto/ativos e não executa pagamentos em nome do usuário — apenas lê e registra lançamentos no controle financeiro pessoal, igual ao app. Toda escrita é explícita e solicitada na conversa.

Para listagens curadas use MCP_TOOLS_MODE=readonly.
Pedido de exceção por escrito (previsto na própria 4.A): docs/4a-exception-request.md.
Conta de teste para revisores: joao@teste.com / 123456 (dados de amostra).

Contribuindo

Veja CONTRIBUTING.md — fork, branch feat/..., npm run build e PR com path validado no backend. Ao contribuir você licencia sob BUSL-1.1.

Licença

Source-available [BUSL-1.1](./LICENSE) — uso com o CDF Finance, pessoal, acadêmico e contribuições são livres. Proibido uso em produção como produto concorrente de gestão financeira (hosted/managed). Converte para Apache-2.0 em 2030-09-01.

Dúvidas comerciais: support@cdf.finance.

Construído com Model Context Protocol · Mantido por Vessell CDF Finance

CDF Finance MCP

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

会計・財務・税務のほかのサーバーとの比較i

よくある質問

代わりの候補

Finance Toolkit

SolidInvoice

Korea Tax Calculator

作者のREADME

CDF Finance MCP

O que é

Exemplos

Arquitetura

Tools

Quick start

Transport: Streamable HTTP → http://localhost:8090/mcp

Variáveis de ambiente

Deploy (Railway)

Segurança

Conformidade — Diretório Anthropic (Seção 4.A)

Contribuindo

Licença