Fixou

Construa sobre a Fixou.

A API REST e o servidor MCP que permitem que um agente de IA crie uma solicitação de orçamento para um cliente final e, em seguida, acompanhe as respostas de artesãos franceses.

A jornada de um agente

Da necessidade expressa em linguagem natural até as respostas dos artesãos, o caminho sempre passa por uma confirmação do cliente final.

1O cliente descreve sua necessidade

Ele explica seu problema ao seu assistente de IA, em linguagem natural: "tenho um vazamento embaixo da minha pia em Marselha".

2O agente cria a solicitação

O agente identifica o ofício, preenche o questionário e chama a API com o email do cliente final.

3O cliente confirma por email

Ele recebe "Confirme sua solicitação" e clica no link, válido por 48 horas. Esse clique, e somente ele, publica a solicitação.

4Os artesãos respondem

A solicitação é enviada aos artesãos da região. O cliente acompanha as respostas e conversa com eles no seu espaço fixou.fr.

Duas formas de integração

As mesmas capacidades, expostas de duas maneiras: uma API REST clássica ou um servidor MCP para conectar diretamente em um assistente.

API REST

Três endpoints descritos por uma especificação OpenAPI 3.1. A autenticação é feita com uma chave Bearer prefixada fixou_sk_, transmitida no cabeçalho Authorization.

openapi.json Referência REST

Servidor MCP

Um servidor Model Context Protocol em https://mcp.fixou.fr/mcp, sem chave no lado do cliente, publicado no registro oficial sob fr.fixou/fixou. Para conectar no Claude ou no ChatGPT como conector personalizado.

Integrar o servidor MCP

Criar uma solicitação em uma única chamada

Um POST /api/v1/requests registra a solicitação com o status pending_confirmation. Nenhum artesão é contatado até que o cliente final confirme por email.

curl -X POST https://fixou.fr/api/v1/requests \
  -H "Authorization: Bearer fixou_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "categorySlug": "plombier",
    "answers": { "type": "fuite", "lieu": "cuisine", "urgence": "urgent" },
    "description": "Fuite sous le lavabo de la cuisine, intervention rapide souhaitee.",
    "postalCode": "13001",
    "email": "[email protected]"
  }'

Exemplo completo e diretamente executável, alinhado com a referência REST.

Pronto para começar?

Nenhum artesão é jamais contatado sem a confirmação por email do cliente final: o duplo opt-in protege seus usuários e a qualidade da rede.