v0.1.0 — Estável

MCP Tech Coffee

Servidor Model Context Protocol que conecta LLMs (Claude Desktop, Cursor, etc.) à API Tech Coffee — CRM, financeiro, estoque, propostas, contratos e relatórios — via ~80 tools tipadas e seguras.

Ver no GitHub O que é MCP?

Por dentro

22

Domínios

Clientes, atividades, financeiro, estoque, OS e mais

80+

Tools MCP

CRUD + buscas custom + relatórios

37

Testes

Unit + integração com MSW

100%

TypeScript

Strict mode, Zod, end-to-end types

Início rápido

1. Instale

npx -y @techcoffee/mcp-server

2. Configure o Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "techcoffee": {
      "command": "npx",
      "args": ["-y", "@techcoffee/mcp-server"],
      "env": {
        "TECHCOFFEE_API_BASE_URL": "https://sua-api.techcoffee.com.br/api/v1",
        "TECHCOFFEE_API_TOKEN": "tc_live_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

3. Pergunte ao Claude

"Liste os clientes do regime Simples Nacional em São Paulo"
"Mostre o relatório de erros das automações dos últimos 7 dias"
"Quantas atividades o usuário ID 5 fez este mês?"

Segurança por padrão

Operações de escrita e exclusão ficam desativadas por padrão. Habilite explicitamente quando confiar no consumidor: 

MCP_ENABLE_WRITE=true        # libera create/update
MCP_ENABLE_DESTRUCTIVE=true  # libera delete (irreversível)

Tokens são mascarados em logs. Stdout é canal MCP — logs vão para stderr. Use sempre o menor conjunto de scopes na API Key.