Formo
Análises de produto e onchain para agentes de IA: consulte KPIs, funis, retenção, receita, usuários e perfis de carteira.
Ver em formo.soExperimente este MCPPatrocinado
Documentação
Visão geral do MCP
Conecte agentes de IA, ferramentas de codificação e aplicativos de terceiros ao Formo com MCP.
Visão geral
O Formo MCP Server permite que assistentes de IA, editores de código e integrações personalizadas consultem seus dados de análise em linguagem natural, usando MCP, um padrão aberto para conectar assistentes de IA a dados externos. Por exemplo:
- "Quantos usuários ativos diários tivemos na semana passada?"
- "Quais são as principais fontes de aquisição neste mês?"
- "Mostre-me a retenção de usuários por coorte"
Aviso
O MCP requer um plano Scale ou Enterprise. Atualize seu workspace para obter acesso.
Primeiros passos
Clientes compatíveis: clientes MCP com suporte a OAuth, como ChatGPT, Claude Desktop, Cursor, Claude Code, Windsurf, VS Code, ou qualquer cliente que suporte transportes MCP HTTP ou stdio.
O Formo suporta dois métodos de autenticação para MCP:
- OAuth (Recomendado) para clientes que gerenciam o login do usuário. Os usuários fazem login no Formo, selecionam um projeto na página de consentimento e escolhem quais permissões aprovar.
- Workspace API Keys para clientes que permitem configurar um cabeçalho
Authorizationmanualmente.
Exemplos de perguntas
Análise de produto
- "Quais são meus KPIs dos últimos 7 dias?"
- "Mostre-me usuários ativos diários do último mês"
- "Em qual estágio do ciclo de vida está a maioria dos meus usuários?"
- "Qual é a taxa de conversão de visualização de página para conexão de carteira?"
Atribuição de marketing
- "Quais são minhas principais fontes de tráfego?"
- "Mostre-me a conversão por fonte UTM"
- "De quais países vêm meus usuários?"
Inteligência de carteira
- "Consulte o perfil deste endereço de carteira, incluindo seu patrimônio líquido"
- "Quais são minhas principais carteiras e blockchains?"
Ferramentas disponíveis
Query API
Endpoints de SQL, exploração e análises pré-construídas.
Permissão: query:read.
| Ferramenta | Descrição |
|---|---|
explore_data | Exploração de dados em linguagem natural com contexto específico do Formo |
execute_query | Execute consultas SQL em seus dados de análise |
text_to_sql | Converta linguagem natural em SQL |
list_endpoints | Liste os endpoints de API disponíveis |
list_datasources | Liste as fontes de dados disponíveis |
kpis | Obtenha indicadores-chave de desempenho |
distinct_values | Obtenha valores únicos para filtragem |
top_events | Veja os eventos mais comuns |
event_timeseries | Contagens de eventos ao longo do tempo |
lifecycle | Detalhamento por estágio do ciclo de vida (novo, recorrente, power, em risco, churn, ressuscitado) |
retention | Retenção de usuários por coorte |
frequency | Com que frequência os usuários retornam |
project_users | Lista de usuários em nível de linha, filtrável por estágio do ciclo de vida, participações em tokens e mais |
top_pages | Analise o desempenho de páginas |
top_sources | Atribuição e fontes de tráfego |
top_locations | Distribuição geográfica |
top_wallets | Carteiras mais ativas |
top_chains | Atividade por blockchain |
revenue_overview | Análise de receita |
revenue_timeseries | Receita ao longo do tempo |
revenue_by_metric | Receita detalhada por uma dimensão |
volume_by_metric | Volume de transações detalhado por uma dimensão |
cohort_analysis | Análise comportamental baseada em coortes |
funnel | Funis de conversão em várias etapas |
flow | Análise de jornada e caminho do usuário |
Profiles API
Enriquecimento de carteiras e gravações de perfil.
| Ferramenta | Descrição | Permissão |
|---|---|---|
search_profile | Consulte o enriquecimento de um único endereço de carteira (patrimônio líquido, tokens, rótulos) | profiles:read |
update_profile_properties | Defina ou remova propriedades de perfil em uma carteira (endereço ou nome ENS); um valor null exclui a propriedade | profiles:write |
upsert_profile_labels | Adicione ou atualize rótulos em uma carteira | profiles:write |
delete_profile_label | Exclua um rótulo de uma carteira | profiles:write |
batch_update_profile_properties | Defina ou remova propriedades de perfil em até 100 carteiras em uma única chamada; valores null excluem | profiles:write |
batch_upsert_profile_labels | Adicione, atualize ou exclua rótulos em até 100 carteiras em uma única chamada (linhas _is_deleted: 1 são tombstone) | profiles:write |
import_wallets | Importe carteiras como usuários identificados (planos Scale e Enterprise; carteiras importadas contam para a cobrança de usuários ativos mensais) | profiles:write |
Alerts
| Ferramenta | Descrição | Permissão |
|---|---|---|
list_alerts, get_alert | Ler alertas | alerts:read |
create_alert, update_alert, toggle_alert, delete_alert | Gerenciar alertas | alerts:write |
Charts
| Ferramenta | Descrição | Permissão |
|---|---|---|
list_boards, get_board, list_charts, get_chart | Ler boards e charts | boards:read |
execute_saved_chart | Executar a consulta de um chart salvo com um intervalo de datas escolhido | boards:read |
create_board, update_board, delete_board | Gerenciar boards | boards:write |
create_chart, update_chart, delete_chart, duplicate_chart, move_chart, reorder_charts | Gerenciar charts | boards:write |
preview_chart | Executar o SQL de um chart sem salvar | query:read |
Contracts
| Ferramenta | Descrição | Permissão |
|---|---|---|
list_contracts, get_contract | Ler contratos rastreados | contracts:read |
create_contract, update_contract, delete_contract | Gerenciar contratos rastreados (a inclusão no pipeline é definida via update_contract) | contracts:write |
Segments
| Ferramenta | Descrição | Permissão |
|---|---|---|
list_segments | Ler segmentos | segments:read |
create_segment, delete_segment | Gerenciar segmentos | segments:write |
Aviso
As ferramentas
delete_*removem dados permanentemente. Elas não serão executadas a menos que a chamada passe"confirm": true, então um assistente precisa pedir sua permissão primeiro, em vez de excluir por conta própria. Conceda permissões de gravação apenas a clientes em que você confia.
Docs
| Ferramenta | Descrição |
|---|---|
search_formo_docs | Pesquise na documentação do Formo |
query_docs_filesystem_formo_docs | Consulte o sistema de arquivos da documentação do Formo |
Solução de problemas
403 MCP access requires a Scale or Enterprise plan: O MCP está disponível apenas nos planos Scale e Enterprise.- Ferramentas não aparecem: Verifique se a URL termina com uma barra final:
https://api.formo.so/v0/mcp/. Reinicie ou atualize seu assistente de IA após alterações de configuração. - Problemas com OAuth: Consulte MCP OAuth para configuração de OAuth, metadados e solução de problemas.
- Problemas com API key: Consulte MCP API Key para configuração de API key e solução de problemas.
Segurança
- Escopo por projeto: cada conexão é limitada a um projeto, selecionado na página de consentimento do OAuth ou anexado à API key.
- Escopo por permissão: cada chamada de ferramenta exige a permissão correspondente (por exemplo,
query:readpara ler análises,alerts:writepara alterar alertas); exclusões também exigem"confirm": true. - Somente owner/admin: apenas um owner ou admin do workspace pode criar uma conexão.
- Nada é retido: o próprio servidor MCP não armazena dados.
- Gerencie a qualquer momento: revise, altere ou revogue o acesso em Configurações → Aplicativos conectados. Desconexões são aplicadas imediatamente; alterações de permissão são aplicadas na reconexão. As sessões expiram após 1 hora de inatividade.