Skip to main content
Gratis - el servidor MCP no está limitado por plan. Cualquier cuenta puede usarlo.
Formpaste incluye un servidor MCP remoto - esta es la vía de integración nativa para agentes de IA real. No hay una “Forms API” o “Provisioning API” REST aparte; un agente que quiera crear o gestionar formularios de forma programática lo hace a través de estas herramientas MCP, igual que una persona lo hace desde el panel.

Endpoint

MCP remoto sin estado sobre Streamable HTTP - sin negociación de sesión/SSE que gestionar. Cada solicitud lleva su propia autenticación y recibe una respuesta autocontenida.

Autenticación

Cada solicitud necesita un token de API de cuenta (fpat_…) como encabezado Bearer estándar:
Este es el único token Bearer en Formpaste. No tiene relación con el access_key de un formulario (usado por POST /submit, no por /mcp) - consulta Access key vs. token de API si no tienes claro cuál necesitas. Genera un token desde el panel en Settings → API & MCP - consulta Tokens de API para más detalles, incluido el hecho de que se muestra exactamente una vez. Los tokens pueden tener alcance limitado: un token completo puede usar todas las herramientas, un token de configuración puede hacer todo excepto leer envíos (list_submissions). Consulta Tokens de API. Un token ausente o revocado no produce un 401 genérico; la llamada a la herramienta devuelve un error MCP accionable:

Instalación (un comando)

Formpaste es un servidor remoto, así que la mayoría de los clientes MCP (Claude Code, Cursor, Claude Desktop) se conectan a él mediante mcp-remote en lugar de un proceso local. Añade esto a la configuración MCP de tu cliente, sustituyendo tu propio token:
Reinicia tu agente/cliente después de guardar la configuración. Debería mostrar formpaste como servidor MCP conectado con seis herramientas disponibles. Para instrucciones específicas por cliente (Claude Code, Codex, Cursor, Claude Desktop, VS Code), consulta Instalación.

Las seis herramientas

Tres de estas - list_forms, get_form y send_test_submission - permiten a un agente verificar su propio trabajo: descubrir ids, releer la configuración de un formulario y demostrar que está recibiendo envíos. Esa es toda la superficie de herramientas. No existe update_form, delete_form ni un CRUD genérico - no están implementados. Si necesitas cambiar el destino de un formulario, los dominios permitidos u otras opciones, hazlo desde el panel.

Para qué sirve

El servidor MCP existe para que un agente (Claude Code, Cursor o cualquier otro que hable MCP) pueda completar una tarea completa como “añade un formulario de contacto a este sitio” sin que salgas de tu editor: llama a create_form, obtiene de vuelta un access_key y un snippet conectado, pega el snippet en tu proyecto y, si quieres que compruebe las respuestas más tarde, llama a list_submissions. Consulta Prompts del recetario para prompts listos para usar que llevan esto de principio a fin. Si prefieres no instalar nada, la vía .env también funciona: crea el formulario tú mismo desde el panel, pon el access_key en .env y pide a tu agente que conecte el snippet usándolo. No se requiere conexión MCP - consulta los prompts de la vía .env en el recetario.

Instalación

Configuración específica por cliente para cada cliente MCP.

create_form

Aprovisiona un formulario y recibe de vuelta un snippet conectado.

list_forms

Descubre ids de formularios y confirma que un formulario existe.

get_form

Lee la configuración de un formulario para verificar su conexión.

send_test_submission

Demuestra que un formulario está activo con un envío de prueba.

Solución de problemas

Resuelve problemas de conexión, autenticación y alcance.