Integração com LLMs
Conecte o Matias a LLMs como Claude, Cursor, Windsurf e outros via Model Context Protocol (MCP). Para agents sem suporte a MCP, use o OpenAPI como fallback.
O que é MCP?
MCP é um protocolo aberto que permite que LLMs chamem ferramentas externas de forma padronizada. O pacote @use-matias/mcp expõe as rotas da API do Matias como tools — o LLM decide quando chamar. Autenticação é feita via x-api-key na variável de ambiente MATIAS_API_KEY.
Tools disponíveis
Apenas create_transaction escreve — todas as demais são read-only.
| Tool | Rota | Descrição |
|---|---|---|
| get_me | GET /auth/me | Perfil do dono da API key |
| create_transaction | POST /financial-records | Cria transação (estruturada ou IA) |
| list_transactions | GET /financial-records | Lista transações com filtros |
| get_transaction_summary | GET /financial-records/summary | Totais consolidados do período |
| export_transactions_csv | GET /financial-records/export/csv | Exporta CSV |
| list_wallets | GET /wallets | Carteiras ativas ou arquivadas |
| get_wallet | GET /wallets/:id | Busca carteira por ID |
| get_wallets_summary | GET /wallets/summary | Resumo agregado das carteiras |
| list_categories | GET /categories/user/active | Categorias ativas do usuário |
| get_analytics_dashboard | GET /analytics | Dashboard de analytics |
| get_analytics_by_category | GET /analytics/by-category | Gastos por categoria |
| get_top_expenses | GET /analytics/top-expenses | Maiores despesas do período |
| get_monthly_summary | GET /analytics/monthly-summary | Resumo mensal |
| list_goals | GET /goals | Lista metas |
| get_goal | GET /goals/:id | Busca meta por ID |
| list_goal_deposits | GET /goals/:id/deposits | Depósitos de uma meta |
| list_alerts | GET /alerts | Lista alertas |
| list_triggered_alerts | GET /alerts/triggered | Alertas disparados |
Plataformas suportadas
Claude Code
Rode no terminal para adicionar o servidor globalmente:
claude mcp add matias \
--env MATIAS_API_KEY=um_live_xxx \
-- npx -y @use-matias/mcpClaude Desktop
Edite claude_desktop_config.json e reinicie o Claude Desktop:
claude_desktop_config.jsonjson
{
"mcpServers": {
"matias": {
"command": "npx",
"args": ["-y", "@use-matias/mcp"],
"env": {
"MATIAS_API_KEY": "um_live_xxx"
}
}
}
}Agents sem suporte a MCP
OpenAI Assistants e qualquer framework que consome OpenAPI podem usar o schema direto:
https://api.matias.com/api/docs-jsonVariáveis de ambiente
MATIAS_API_KEY— obrigatório. Gere em/api-keysdo dashboard.MATIAS_API_URL— opcional. Defaulthttps://api.matias.com/v1. Em dev aponte parahttp://localhost:3000/v1.