Construa um gateway inteligente sobre a API Filazero para agentes de IA.
Transforme endpoints REST complexos em tools padronizadas que qualquer agente de IA (Claude, GPT, etc.) possa consumir de forma conversacional e natural.
A Filazero é uma startup SaaS de Aracaju que elimina filas presenciais através de virtualização e previsão em tempo real via machine learning.
| Recurso | URL |
|---|---|
| API Base (Staging) | https://api.staging.filazero.net |
| Site Homologação | https://site.staging.filazero.net/ |
| Backoffice (Staging) | https://app.staging.filazero.net |
| 🎬 Treinamento da Plataforma | Playlist no YouTube |
Tools são funções que o agente pode chamar. Cada uma deve ter nome, descrição, schema JSON e lógica de orquestração.
| # | Tool | Descrição | Auth |
|---|---|---|---|
| 1 | list_companies |
Lista empresas disponíveis para agendamento | Pública |
| 2 | get_company_services |
Serviços de uma empresa específica | Pública |
| 3 | get_available_dates |
Dias do mês com vagas disponíveis | Pública |
| 4 | get_available_sessions |
Horários e profissionais de um dia | Pública |
| 5 | get_booking_form |
Campos personalizados do formulário | Pública |
| 6 | schedule_appointment |
Emite o ticket de agendamento | Bearer Token |
| 7 | check_ticket_status |
Consulta status de um ticket | Pública |
| 8 | list_my_tickets |
Lista tickets do usuário logado | Bearer Token |
| Resource | URI |
|---|---|
categories |
filazero://categories |
ticket-lifecycle |
filazero://ticket-lifecycle |
flow-guide |
filazero://scheduling-flow |
| Prompt | Descrição |
|---|---|
agendar-atendimento |
Fluxo completo de agendamento |
consultar-agendamento |
Verificar status de ticket |
| Endpoint | Método | Descrição |
|---|---|---|
/api/companies |
GET | Lista todas as empresas |
/api/companies/{slug}/services |
GET | Serviços da empresa |
/api/companies/{slug}/template |
GET | Template visual (cores, logo) |
/api/companies/{slug}/business-units |
GET | Unidades de atendimento |
| Endpoint | Método | Descrição |
|---|---|---|
/v2/scheduling/self-service/providers/{slug}/services/{serviceId}/available-session-days |
GET | Dias disponíveis no mês |
/v2/scheduling/self-service/providers/{slug}/locations/{locationId}/services/{serviceId}/sessions-resources-by-service |
GET | Sessões do dia |
/api/providers/{providerId}/sessions/{sessionId}/custom-fields |
GET | Campos do formulário |
| Endpoint | Método | Auth | Descrição |
|---|---|---|---|
/v2/ticketing/tickets |
POST | Bearer | Emitir ticket |
/v2/ticketing/public/ticket?key={accessKey} |
GET | Pública | Consulta por chave |
/v2/ticketing/me/filtered-tickets |
GET | Bearer | Meus tickets |
Estas regras são essenciais para o funcionamento correto do MCP Server. Leiam com atenção.
id e abstractServiceId. Use SEMPRE o abstractServiceId quando disponível e maior que zero. Se usar o ID errado, a API retorna 200 com dados vazios — sem erro.Content-Type: application/json;charset=UTF-8. Sem o charset=UTF-8, a API retorna 403 Forbidden.messages na resposta para identificar erros.America/Sao_Paulo antes de exibir ao usuário.// Resolver abstractServiceId corretamente function resolveServiceRef(service: any): number { if (service.abstractServiceId && service.abstractServiceId > 0) { return service.abstractServiceId; } return service.id; } // Verificar erros de negócio na resposta function checkApiErrors(response: any): void { if (response.messages?.length > 0) { const errors = response.messages.filter((m: any) => m.type === 'ERROR'); if (errors.length > 0) { throw new Error(errors[0].description); } } }
const REQUIRED_HEADERS = { 'Accept': 'application/json, text/plain, */*', 'Origin': 'https://app.filazero.net', 'Referer': 'https://app.filazero.net/', 'User-Agent': 'MCP-Server-FilaZero/1.0', 'DNT': '1', }; // Para POST/PUT/PATCH, adicionar: const WRITE_HEADERS = { 'Content-Type': 'application/json;charset=UTF-8', // charset é OBRIGATÓRIO! };
| Recurso | Link |
|---|---|
| 🎬 Treinamento Filazero (YouTube) | Playlist Completa |
| MCP Specification | modelcontextprotocol.io/specification |
| MCP TypeScript SDK | github.com/modelcontextprotocol/typescript-sdk |
| MCP Inspector | github.com/modelcontextprotocol/inspector |
| Claude Desktop | claude.ai/download |
| Variável | Default | Descrição |
|---|---|---|
FILAZERO_API_URL |
https://api.staging.filazero.net | URL base da API |
FILAZERO_APP_ORIGIN |
https://app.filazero.net | Origin para headers |
MCP_SERVER_PORT |
3000 | Porta do servidor |
RATE_LIMIT_RPM |
30 | Requisições/min por tenant |
CACHE_TTL_COMPANIES |
300 | TTL em segundos |
LOG_LEVEL |
info | Nível de log |