Fixou

Construye sobre Fixou.

La API REST y el servidor MCP que permiten a un agente de IA crear una solicitud de presupuesto para un cliente final, y luego hacer seguimiento de las respuestas de artesanos franceses.

El recorrido de un agente

Desde la necesidad expresada en lenguaje natural hasta las respuestas de los artesanos, el camino siempre pasa por una confirmación del cliente final.

1El cliente describe su necesidad

Le explica su problema a su asistente de IA, en lenguaje natural: «tengo una fuga debajo de mi fregadero en Marsella».

2El agente crea la solicitud

El agente identifica el oficio, completa el cuestionario y llama a la API con el email del cliente final.

3El cliente confirma por email

Recibe «Confirme su solicitud» y hace clic en el enlace, válido por 48 h. Ese clic, y solo ese, publica la solicitud.

4Los artesanos responden

La solicitud se envía a los artesanos de la zona. El cliente sigue las respuestas y conversa con ellos en su espacio fixou.fr.

Dos vías de integración

Las mismas capacidades, expuestas de dos maneras: una API REST clásica, o un servidor MCP para conectar directamente en un asistente.

API REST

Tres endpoints descritos por una especificación OpenAPI 3.1. La autenticación se realiza con una clave Bearer con prefijo fixou_sk_, transmitida en el encabezado Authorization.

openapi.json Referencia REST

Servidor MCP

Un servidor Model Context Protocol en https://mcp.fixou.fr/mcp, sin clave del lado del cliente, publicado en el registro oficial bajo fr.fixou/fixou. Para conectar en Claude o ChatGPT como conector personalizado.

Integrar el servidor MCP

Crear una solicitud en una llamada

Un POST /api/v1/requests registra la solicitud con el estado pending_confirmation. Ningún artesano es contactado hasta que el cliente final haya confirmado 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]"
  }'

Ejemplo completo y directamente ejecutable, alineado con la referencia REST.

¿Listo para empezar?

Ningún artesano es contactado jamás sin la confirmación por email del cliente final: el doble opt-in protege a tus usuarios y la calidad de la red.