CDF Finance MCP

Name: CDF Finance MCP
Author: VessellTech

de VessellTechversión 0.1.8i★ –iSe ejecuta en la nube

Nombre en el registroio.github.VessellTech/cdf.mcp

Instalar

Resumen

Descripción del creador (original en inglés)

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

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiAún sin medir★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en la nube
Transporte: Streamable HTTP
Categoría: Contabilidad, finanzas e impuestos

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en el servidor del creador: lo que le pidas pasa por su servidor.
El registro no indica ninguna clave que completar.

Necesitas

Se ejecuta en la nubeNo hay nada que instalar; se conecta por internet

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Funciona en Claude para web, escritorio y móvil:

Abre Settings → Connectors
Presiona Add custom connector
Pega la dirección de abajo y presiona Add
Si te pide iniciar sesión, inicia sesión en el servicio del creador

https://mcp.cdf.finance/mcp

Ejecuta esto en tu terminal

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

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

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

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

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

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

ChatGPT solo se conecta a servidores en internet:

Abre ChatGPT en la web → Settings → Connectors (Apps)
Presiona Create o Add (en algunos planes primero hay que activar Developer mode en Advanced)
Pega la dirección de abajo, ponle un nombre y guarda
Si te pide iniciar sesión, inicia sesión en el servicio del creador

https://mcp.cdf.finance/mcp

Los nombres de los menús pueden variar un poco según el plan y con el tiempo.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Todavía no hemos leído la lista de herramientas de este servidor; revisamos los endpoints por turnos.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 7 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub VessellTech, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
El endpoint responde
Aún sin revisar; revisamos los endpoints por turnos
… Aún sin revisar
Inicio de sesión con OAuth
Aún sin revisar; revisamos los endpoints por turnos
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Aún sin revisar; leemos la lista de herramientas cuando revisamos el endpoint

Comparado con otros en Contabilidad, finanzas e impuestosi

Más estrellas que el 0% de los otros 1730 servidores de esta categoría
Publicado en el registro más recientemente que el 41% de los otros 1730 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 1730 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro CDF Finance MCP?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.1.8) llegó al registro hace 2 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también funcionan las apps que aceptan servidores MCP remotos, como ChatGPT en modo desarrollador.

¿Qué puedo usar en su lugar?

En la misma categoría: Finance Toolkit, SolidInvoice, Korea Tax Calculator

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Finance Toolkit

de JerBouma

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

Computadora o nube★ 5496MITActualizado hoy

Instalar

SolidInvoice

de SolidInvoice

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

Se ejecuta en la nube★ 981MITActualizado hace 8 días

Instalar

Korea Tax Calculator

de UpstageAI

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

Se ejecuta en tu computadora★ 97MITActualizado ayer

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Contabilidad, finanzas e impuestosi

Preguntas frecuentes

Alternativas

Finance Toolkit

SolidInvoice

Korea Tax Calculator

README del creador

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