MCP y asistentes

Endpoint: https://docs.tochihub.cl/v1/mcp. Transporte Streamable HTTP sin estado; POST con JSON-RPC, sin sesión persistente. GET/DELETE responden 405. Autentica con x-api-key; cada tool valida su scope. Crear propiedades con LIVE modifica datos reales; empieza con TEST. Recursos: tochihub://docs.md (text/markdown) y tochihub://openapi.json (application/json), requieren properties:read.

Claude Code

claude mcp add --transport http tochihub https://docs.tochihub.cl/v1/mcp --header "x-api-key: th_test_REEMPLAZAR"

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "tochihub": {
      "url": "https://docs.tochihub.cl/v1/mcp",
      "headers": {
        "x-api-key": "th_test_REEMPLAZAR"
      }
    }
  }
}

Tools y scopes

• search_properties (properties:read): Buscar propiedades paginadas, incluido externalId del CRM.
• get_property (properties:read): Leer una propiedad con sus fotos.
• get_api_reference (properties:read): Leer docs.md u openapi.json, el contrato completo de integración.
• validate_property_payload (properties:read): Validar un payload o propiedad existente con los mappers reales, sin publicar.
• create_property (properties:write): Crear una propiedad, en sandbox con th_test_ o en producción con th_live_. Admite Idempotency-Key.
• get_publication_status (properties:read): Consultar estado, URL y errores por portal.
• list_webhook_events (properties:read): Leer catálogo y ejemplos de eventos.
• send_test_webhook (properties:write): Enviar un evento de prueba a un webhook existente de la corredora.
• get_integration_status (properties:read): Ver últimas 50 solicitudes de esta key (7 días), endpoints y últimas 50 entregas de su corredora.

Errores de las tools

Una tool que falla responde con isError: true y el mismo cuerpo de error que la API REST, sin requestId: { "error": { "code": "bad_request", "message": "El payload no cumple el contrato de la API", "details": ["bedrooms must be an integer number", "property foo should not exist"] } }. details nombra cada campo inválido (con su ruta, por ejemplo media.0.url) para que el asistente corrija el mapeo y reintente. get_integration_status muestra las URLs de webhooks sin query string ni credenciales.

Prompt sugerido: "Lee get_api_reference, mapea los campos de mi CRM, valida una propiedad para YAPO y TOCTOC, créala con esta key sandbox y revisa get_publication_status y get_integration_status. No uses una key de producción."