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.
接入你的智能体
發布者自己的 URL。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
https://mcp.cdf.finance/mcp上方的 Claude 按鈕會開啟 Claude,並填好名稱和 URL。你仍需在那裡確認。
claude mcp add --transport http io.github.vesselltech-cdf.mcp https://mcp.cdf.finance/mcpRun in a terminal.
{ "mcpServers": { "io.github.vesselltech-cdf.mcp": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.cdf.finance/mcp" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
Remoto: https://mcp.cdf.finance/mcp (Streamable HTTP) · Website: https://cdf.finance/mcp · Status: https://status.cdf.finance · Suporte: [email protected]
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).
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.0em2030-09-01.
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."
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 <mobile JWT>
▼
backend-husk (api.vessell.app)
API pública — mesmo contrato do app mobile
Fluxo de login:
/register./authorize (form server-rendered, sem terceiros) → POST /api/mobile/auth/login com device_id=mcp-<sessionId>, platform=mcp.access/refresh do backend ficam criptografados em sessions; client MCP recebe apenas token opaco (oauth_tokens).access_token via refresh automaticamente (getValidAccessToken).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.
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.
Fora de escopo de propósito (igual ao backend): admin, Stripe/pagamentos, webhooks, S3/anexos, /api/ai/*.
Modo somente leitura:
MCP_TOOLS_MODE=readonlyexpõe sóreadOnly:true— ideal para diretórios curados.
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
Ver .env.example comentado.
railway init ou conecte o repo no dashboard.DATABASE_URL).Dockerfile → node dist/index.js (railway.json já configurado).railway run npm run db:migrate.https://<seu-dominio>.up.railway.app/mcp — DCR/OAuth é automático.authorization_code.SHA-256 persiste (oauth_tokens), bruto é entregue uma vez.AES-256-GCM em sessions — nunca exposto ao client (src/crypto.ts, src/mcp/http.ts).mcp-<id> (src/backend/client.ts:45) revogável sem afetar outros logins.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: [email protected] [SECURITY].
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.
MCP_TOOLS_MODE=readonly.docs/4a-exception-request.md.[email protected] / 123456 (dados de amostra).Veja CONTRIBUTING.md — fork, branch feat/..., npm run build e PR com path validado no backend. Ao contribuir você licencia sob BUSL-1.1.
Source-available BUSL-1.1 — 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: [email protected].
Consulte contas, cartões, transações e orçamentos da sua conta financeira Vessell.
{ "mcpServers": { "io.github.vesselltech-cdf.mcp": { "url": "https://mcp.cdf.finance/mcp", "headers": {} } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 http 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
CDF Finance MCP 透過 HTTP 存取。
上次檢查時間:2026-11-09。 Consulte contas, cartões, transações e orçamentos da sua conta financeira Vessell.