How do I use Ecuro Light API MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Ecuro Light API MCP Server find the next available dental appointments for tomorrow" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP Server – Ecuro Light API

Repositório: github.com/creeai/mcp

Servidor MCP (Model Context Protocol) que expõe as ferramentas da API Ecuro Light para clientes como Cursor, Claude Desktop, etc. Inclui agendamento, pacientes, disponibilidade, clínicas, relatórios e comunicações.

Requisitos

Node.js 20+
Conta Ecuro com token de acesso à API

Variáveis de ambiente

Variável	Obrigatório	Descrição
`ECURO_BASE_URL`	Sim	Base URL da API (ex: `https://clinics.api.ecuro.com.br/api/v1/ecuro-light`)
`ECURO_APP_ACCESS_TOKEN`	Sim	Token no header `app-access-token`
`PORT`	Não	Porta HTTP (default: `3000`)

Copie .env.example para .env e preencha os valores.

Uso local

npm install cp .env.example .env # Edite .env com ECURO_BASE_URL e ECURO_APP_ACCESS_TOKEN npm run build npm start

Health: GET http://localhost:3000/health
MCP (Streamable HTTP): POST http://localhost:3000/mcp (e GET para SSE quando aplicável)

Conectar no Cursor / Claude

No Cursor, adicione o servidor MCP em configurações (por exemplo em .cursor/mcp.json ou nas configurações do projeto):

{ "mcpServers": { "ecuro-light": { "type": "streamable-http", "url": "http://localhost:3000/mcp" } } }

Para uso em VPS, use a URL pública com HTTPS se houver proxy (ex: https://seu-dominio.com/mcp).

Deploy no EasyPanel (VPS)

Passo a passo completo: DEPLOY.md (inclui envio do código para o GitHub creeai/mcp e deploy no EasyPanel).

Resumo:

Envie o código para o repo creeai/mcp (ver comandos em DEPLOY.md).
No EasyPanel, crie um app a partir do repositório creeai/mcp e use Dockerfile como método de build.
Configure as variáveis: ECURO_BASE_URL, ECURO_APP_ACCESS_TOKEN; PORT opcional.
Exponha a porta (ex.: 3000) e use GET /health como health check (opcional).

Ferramentas expostas (27)

Agendamento: create_appointment, update_appointment, confirm_appointment, update_appointment_full, list_appointments_of_patient, list_appointments_of_doctor, get_appointments_appid, list_returns
Disponibilidade: specialty_availability, clinic_dates, blockers_for_clinic, dentist_availability
Pacientes: get_patient_by_phone, get_patient_by_cpf, patient_details, list_patients, patient_incomplete_treatments, orto_patients
Clínicas: list_clinics, list_specialties, active_dentists, get_clinic_logo
Relatórios: export_csv, apireport, list_boletos
Comunicações: communication_mark_read, onboarding_event