@valorasolucoes/mcp-kanban

MCP server que expoe o kanban da Valora (https://smartpay.valorasolucoes.com) para assistentes compativeis com o Model Context Protocol (Claude Code, Cursor, Cline, etc).

Uso

Adicione ao seu arquivo de config MCP (.claude/mcp.json ou ~/.claude.json):

{
  "mcpServers": {
    "valora-kanban": {
      "command": "npx",
      "args": ["-y", "@valorasolucoes/mcp-kanban"],
      "env": {
        "VALORA_API_URL": "https://smartpay.valorasolucoes.com/api",
        "VALORA_API_KEY": "vlr_xxx..."
      }
    }
  }
}

A API key (vlr_...) deve ser gerada em /admin/api-keys no painel da Valora por um usuario com permissao ADMIN.

Ferramenta exposta

valora_request(method, path, body?, query?) — proxy autenticado para qualquer endpoint da API do kanban. Permite listar, criar, atualizar, mover, remover cards e enviar ao Pipedrive.

Endpoints disponiveis:

• GET /kanban/cards
• POST /kanban/cards
• PATCH /kanban/cards/:id
• PATCH /kanban/cards/:id/move
• DELETE /kanban/cards/:id
• POST /kanban/cards/:id/pipedrive

Seguranca

A chave tem o mesmo poder do usuario dono. Se vazar, revogue em /admin/api-keys.

Requisitos

• Node.js >= 20

Licenca

MIT