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ável	Descrição	Obrigatório
CAAS_API_URL	URL base da API (default: sandbox)	Não
CAAS_JWT_SUB	ID da chave API (do portal)	Sim
CAAS_JWT_PRIVATE_KEY	Chave 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.