Pular para o conteúdo principal

Servidor MCP

O servidor MCP (Model Context Protocol) permite que assistentes de IA como o Claude interajam diretamente com a API do CaaS. Todas as operações da API são expostas como tools que o AI pode chamar.

O que é MCP?​

O Model Context Protocol é um padrão aberto que permite que modelos de AI acessem ferramentas externas de forma segura. Com o servidor MCP do CaaS, você pode pedir ao Claude para consultar saldos, criar ordens, listar mercados, etc. — tudo via linguagem natural.

Configuração no Claude Desktop​

Adicione ao arquivo claude_desktop_config.json:

{
"mcpServers": {
"caas-api": {
"command": "npx",
"args": ["@liqi-da/caas-mcp-server"],
"env": {
"CAAS_API_URL": "https://api-caas-it-sandbox.liqi.app.br",
"CAAS_JWT_SUB": "SEU_API_KEY_ID",
"CAAS_JWT_PRIVATE_KEY": "SUA_CHAVE_PRIVADA_SEM_PREFIXOS"
}
}
}
}

Não é necessário clonar nenhum repositório — o npx baixa e executa o pacote automaticamente.

Configuração no Claude Code​

claude mcp add caas-api -- npx @liqi-da/caas-mcp-server

Configure as variáveis de ambiente no seu shell antes de executar.

Variáveis de Ambiente​

VariávelDescriçãoObrigatório
CAAS_API_URLURL base da API (default: sandbox)Não
CAAS_JWT_SUBID da chave API (do portal)Sim
CAAS_JWT_PRIVATE_KEYChave privada RSA (sem BEGIN/END, sem quebras)Sim

Tools Disponíveis​

O servidor expõe 28 tools organizadas por domínio:

  • Autenticação — auth_signin
  • Cliente — account_createProfile, account_fetchProfile, account_fetchProfiles, account_enableDisableProfile
  • Carteira — wallet_fetchBalance, wallet_fetchBalances, wallet_fetchStatement, wallet_fetchStatementCategory
  • Mercados — market_fetchExchanges, market_fetchMarkets, market_fetchTicker, market_fetchTickers, market_fetchHistoricalPrices
  • Ordens — orders_createOrder, orders_fetchOrder, orders_fetchOrders
  • Ordens RFQ — orders_rfq_createQuote, orders_rfq_fetchQuote, orders_rfq_createOrder
  • Transações — transactions_createTransfer, transactions_fetchTransfer, transactions_fetchTransfers, transactions_createBalance, transactions_fetchBalance, transactions_fetchBalances, transactions_createDeposit, transactions_fetchDeposit
  • Analíticos — analytics_poolsBalances

Exemplo de Uso​

Após configurar, peça ao Claude:

"Liste os mercados disponíveis na minha conta CaaS"

"Qual o saldo do profile cliente-123?"

"Crie uma ordem de compra de R$100 em BTC/BRL para o profile cliente-456"

O Claude chamará automaticamente as tools correspondentes.