FixPayment

MCP FixPayment para Credores

Documentação

Servidor MCP FixPayment

Um servidor FastMCP que expõe uma API voltada para credores do portal FixPayment.
Conecte qualquer assistente de IA habilitado para MCP (ex.: Claude) à sua conta FixPayment para criar contas, atualizar status e gerar relatórios — tudo em linguagem natural.

URL do servidor MCP: http://fixpayment.org:8000
Documentação: https://fixpayment.org/mcp/fixpayment-mcp.html
Suporte: support@fixpayment.org

Início Rápido

# 1. Clone & install dependencies
pip install -r requirements.txt

# 2. Configure credentials
cp .env.example .env
# Edit .env and set FIXPAYMENT_DB_* variables

# 3. Run the server
python -m mcp.server
# or via FastMCP CLI:
fastmcp run mcp/server.py:mcp

Variáveis de Ambiente

Variável	Descrição	Padrão
`FIXPAYMENT_DB_HOST`	Host do PostgreSQL	`localhost`
`FIXPAYMENT_DB_PORT`	Porta do PostgreSQL	`54432`
`FIXPAYMENT_DB_NAME`	Nome do banco de dados	`fixpayment_db`
`FIXPAYMENT_DB_USER`	Usuário do banco de dados	`fixpayment_user`
`FIXPAYMENT_DB_PASS`	Senha do banco de dados	(obrigatório)
`FIXPAYMENT_UPLOAD_PATH`	Diretório raiz de upload	`/var/www/fixpayment/uploads/`

Modelo de Autenticação

Cada ferramenta MCP exige um argumento api_key.
A chave mapeia para um creditor_id e um plan (basic, reports ou full) na tabela mcp_api_keys.

Planos e Ferramentas

Ferramenta	básico	relatórios	completo
`ping`	✓	✓	✓
`get_plan_info`	✓	✓	✓
`get_account_summary`	✓	✓	✓
`list_accounts_basic`	✓	✓	✓
`validate_account_payload`	✓	✓	✓
`accounts_report`		✓	✓
`payments_report`		✓	✓
`settlements_report`		✓	✓
`performance_report`		✓	✓
`create_account`			✓
`bulk_create_accounts`			✓
`update_account_status`			✓
`add_account_document`			✓

Estrutura do Projeto

fixpayments/
├── mcp/
│   ├── __init__.py
│   ├── server.py          # FastMCP instance + entrypoint
│   ├── db.py              # DB connection helper
│   ├── auth.py            # API key validation
│   └── tools/
│       ├── __init__.py
│       ├── basic.py       # Basic plan tools (5 tools)
│       ├── reports.py     # Reports plan tools (4 tools)
│       └── accounts.py    # Full plan tools (4 tools)
├── docs/
│   └── fixpayment-mcp.html
├── .env.example
├── .gitignore
├── requirements.txt
└── README.md

Esquema do Banco de Dados (tabelas obrigatórias)

mcp_api_keys — api_key, creditor_id, plan, active, expires_at
fixpayment_accounts — tabela de contas
fixpayment_payments — tabela de pagamentos
fixpayment_settlements — tabela de liquidações
fixpayment_account_documents — anexos de documentos

Para solicitar uma chave de API ou fazer upgrade do seu plano, envie um e-mail para support@fixpayment.org.