Portal de desarrolladores

APIs públicas del sitio de Comunidad App para agentes de IA e integradores: contacto (con Turnstile), MCP y documentos de discovery. El panel gestor (gestor.comunidadapp.es) es una aplicación autenticada aparte y no forma parte de esta superficie.

Quickstart

El formulario de contacto del sitio es la vía pública para enviar un mensaje. Requiere Cloudflare Turnstile. No hay registro OAuth ni tokens de máquina.

Envía un mensaje desde /contacto/ con un token Turnstile válido.

Especificación OpenAPI

La especificación OpenAPI 3.1 describe los endpoints públicos. Úsala para generar clientes o para que un agente comprenda la API automáticamente.

• /openapi.json
• /api/openapi.json
• /api/openapi.yaml

Sandbox

El host de staging replica las mismas rutas de API, OpenAPI y MCP. Úsalo para pruebas de agentes sin afectar el tráfico de producción.

https://new.comunidadapp.es

MCP

El servidor MCP expone la herramienta contact_comunidadapp (no envía correo) y una UI que enlaza al formulario público con Turnstile.

• /mcp
• /.well-known/mcp/server-card.json

Rate limits

Los POST públicos están limitados por IP. Un 429 incluye Retry-After y cabeceras RateLimit-*. Esto no sustituye la protección perimetral (firewall / Cloudflare) frente a un DDoS volumétrico.

Endpoint	Limit
POST /api/contact	8 / hour / IP
POST /mcp	60 / minute / IP

Endpoints

• OpenAPI JSON — /openapi.json
• OpenAPI YAML — /api/openapi.yaml
• MCP endpoint — /mcp
• MCP server card — /.well-known/mcp/server-card.json
• Sandbox — https://new.comunidadapp.es