Formo
Analítica de producto y onchain para agentes de IA: consulta KPIs, embudos, retención, ingresos, usuarios y perfiles de billetera.
Ver en formo.soPrueba este MCPPatrocinado
Documentación
Resumen de MCP
Conecta agentes de IA, herramientas de codificación y aplicaciones de terceros a Formo con MCP.
Resumen
El servidor MCP de Formo permite que asistentes de IA, editores de código e integraciones personalizadas consulten tus datos de análisis en lenguaje natural, mediante MCP, un estándar abierto para conectar asistentes de IA a datos externos. Por ejemplo:
- "¿Cuántos usuarios activos diarios tuvimos la semana pasada?"
- "¿Cuáles son las principales fuentes de adquisición este mes?"
- "Muéstrame la retención de usuarios por cohorte"
Advertencia
MCP requiere un plan Scale o Enterprise. Mejora tu espacio de trabajo para obtener acceso.
Primeros pasos
Clientes compatibles: clientes MCP con capacidad OAuth como ChatGPT, Claude Desktop, Cursor, Claude Code, Windsurf, VS Code, o cualquier cliente que admita transportes MCP HTTP o stdio.
Formo admite dos métodos de autenticación para MCP:
- OAuth (Recomendado) para clientes que gestionan el inicio de sesión de usuarios. Los usuarios inician sesión en Formo, seleccionan un proyecto en la página de consentimiento y eligen qué permisos aprobar.
- Workspace API Keys para clientes que te permiten configurar un encabezado
Authorizationmanualmente.
Preguntas de ejemplo
Análisis de producto
- "¿Cuáles son mis KPIs de los últimos 7 días?"
- "Muéstrame los usuarios activos diarios del último mes"
- "¿En qué etapa del ciclo de vida se encuentra la mayoría de mis usuarios?"
- "¿Cuál es la tasa de conversión de vista de página a conexión de wallet?"
Atribución de marketing
- "¿Cuáles son mis principales fuentes de tráfico?"
- "Muéstrame la conversión por fuente UTM"
- "¿De qué países provienen mis usuarios?"
Inteligencia de wallets
- "Consulta el perfil de esta dirección de wallet, incluido su patrimonio neto"
- "¿Cuáles son mis principales wallets y cadenas?"
Herramientas disponibles
Query API
Endpoints de SQL, exploración y análisis predefinidos.
Permiso: query:read.
| Herramienta | Descripción |
|---|---|
explore_data | Exploración de datos en lenguaje natural con contexto específico de Formo |
execute_query | Ejecuta consultas SQL sobre tus datos de análisis |
text_to_sql | Convierte lenguaje natural a SQL |
list_endpoints | Enumera los endpoints de API disponibles |
list_datasources | Enumera las fuentes de datos disponibles |
kpis | Obtén indicadores clave de rendimiento |
distinct_values | Obtén valores únicos para filtrar |
top_events | Consulta los eventos más comunes |
event_timeseries | Conteo de eventos a lo largo del tiempo |
lifecycle | Desglose por etapa del ciclo de vida (nuevos, recurrentes, activos, en riesgo, perdidos, recuperados) |
retention | Retención de usuarios por cohorte |
frequency | Con qué frecuencia regresan los usuarios |
project_users | Lista de usuarios a nivel de fila, filtrable por etapa del ciclo de vida, tenencias de tokens y más |
top_pages | Analiza el rendimiento de páginas |
top_sources | Atribución y fuentes de tráfico |
top_locations | Distribución geográfica |
top_wallets | Wallets más activas |
top_chains | Actividad por blockchain |
revenue_overview | Análisis de ingresos |
revenue_timeseries | Ingresos a lo largo del tiempo |
revenue_by_metric | Ingresos desglosados por una dimensión |
volume_by_metric | Volumen de transacciones desglosado por una dimensión |
cohort_analysis | Análisis de comportamiento basado en cohortes |
funnel | Embudos de conversión de varios pasos |
flow | Análisis del recorrido y la ruta del usuario |
Profiles API
Enriquecimiento de wallets y escritura de perfiles.
| Herramienta | Descripción | Permiso |
|---|---|---|
search_profile | Consulta el enriquecimiento de una única dirección de wallet (patrimonio neto, tokens, etiquetas) | profiles:read |
update_profile_properties | Establece o elimina propiedades de perfil en una wallet (dirección o nombre ENS); un valor null elimina la propiedad | profiles:write |
upsert_profile_labels | Añade o actualiza etiquetas en una wallet | profiles:write |
delete_profile_label | Elimina una etiqueta de una wallet | profiles:write |
batch_update_profile_properties | Establece o elimina propiedades de perfil en hasta 100 wallets en una sola llamada; los valores null eliminan | profiles:write |
batch_upsert_profile_labels | Añade, actualiza o elimina etiquetas en hasta 100 wallets en una sola llamada (las filas _is_deleted: 1 se marcan como eliminadas) | profiles:write |
import_wallets | Importa wallets como usuarios identificados (planes Scale y Enterprise; las wallets importadas cuentan para la facturación de usuarios activos mensuales) | profiles:write |
Alertas
| Herramienta | Descripción | Permiso |
|---|---|---|
list_alerts, get_alert | Leer alertas | alerts:read |
create_alert, update_alert, toggle_alert, delete_alert | Gestionar alertas | alerts:write |
Gráficos
| Herramienta | Descripción | Permiso |
|---|---|---|
list_boards, get_board, list_charts, get_chart | Leer paneles y gráficos | boards:read |
execute_saved_chart | Ejecutar la consulta de un gráfico guardado con un rango de fechas elegido | boards:read |
create_board, update_board, delete_board | Gestionar paneles | boards:write |
create_chart, update_chart, delete_chart, duplicate_chart, move_chart, reorder_charts | Gestionar gráficos | boards:write |
preview_chart | Ejecutar el SQL de un gráfico sin guardar | query:read |
Contratos
| Herramienta | Descripción | Permiso |
|---|---|---|
list_contracts, get_contract | Leer contratos rastreados | contracts:read |
create_contract, update_contract, delete_contract | Gestionar contratos rastreados (la inclusión en el pipeline se establece mediante update_contract) | contracts:write |
Segmentos
| Herramienta | Descripción | Permiso |
|---|---|---|
list_segments | Leer segmentos | segments:read |
create_segment, delete_segment | Gestionar segmentos | segments:write |
Advertencia
Las herramientas
delete_*eliminan datos de forma permanente. No se ejecutarán a menos que la llamada incluya"confirm": true, por lo que un asistente debe pedirte permiso primero en lugar de eliminar por su cuenta. Otorga permisos de escritura solo a clientes en los que confíes.
Documentación
| Herramienta | Descripción |
|---|---|
search_formo_docs | Buscar en la documentación de Formo |
query_docs_filesystem_formo_docs | Consultar el sistema de archivos de la documentación de Formo |
Solución de problemas
403 MCP access requires a Scale or Enterprise plan: MCP está disponible solo en los planes Scale y Enterprise.- Las herramientas no aparecen: Comprueba que la URL termine con una barra final:
https://api.formo.so/v0/mcp/. Reinicia o actualiza tu asistente de IA después de los cambios de configuración. - Problemas de OAuth: Consulta MCP OAuth para la configuración, los metadatos y la solución de problemas de OAuth.
- Problemas con la clave de API: Consulta MCP API Key para la configuración y la solución de problemas de la clave de API.
Seguridad
- Limitado al proyecto: cada conexión se limita a un proyecto, ya sea seleccionado en la página de consentimiento de OAuth o adjunto a la clave de API.
- Limitado por permisos: cada llamada a una herramienta requiere el permiso correspondiente (p. ej.,
query:readpara leer análisis,alerts:writepara cambiar alertas); las eliminaciones requieren además"confirm": true. - Solo propietario/administrador: solo el propietario o administrador del espacio de trabajo puede crear una conexión.
- No se retiene nada: el propio servidor MCP no almacena datos.
- Gestiona en cualquier momento: revisa, cambia o revoca el acceso en Configuración → Aplicaciones conectadas. Las desconexiones se aplican de inmediato; los cambios de permisos se aplican al reconectar. Las sesiones caducan después de 1 hora de inactividad.