Integrações MCP

Ativado pelo operador · evidência local

Dê a um agente ferramentas estruturadas de descoberta e composição, mantendo a autorização no FloFi.

Conecte uma implantação configurada

O gateway é POST /api/mcp na implantação web do FloFi, usando Streamable HTTP. O operador ativa FLOFI_MCP e, para clientes de consumo, o OAuth do FloFi com estado persistente em PostgreSQL e um FLOFI_PUBLIC_ORIGIN exato. Essas são configurações do servidor.

Implementado não é aprovado ao vivoA integração tem evidência MOCKED/loopback. Isso não comprova aceitação ao vivo no ChatGPT ou no Claude, nem execução de transações públicas. A configuração do operador e a aceitação pelo cliente continuam separadas.

As ferramentas seguem escopos explícitos

Escopo	Ferramentas
flofi.strategy	get_supported_networks, get_supported_assets, get_capabilities, plan_strategy, compose_strategy, validate_strategy, review_strategy, simulate_strategy
flofi.approval	request_user_approval, get_approval_status; as ferramentas de sessão de aprovação são só do app
flofi.runs	get_execution_status, get_evidence para carteiras vinculadas no FloFi

As entradas usam JSON Schemas fechados. A mesma StrategySpec e o mesmo hash do fluxo são usados pelo app, pela API e pelo MCP. Sequências suportadas usam o executor sequencial existente quando a implantação ativa execuções de fluxo; cada passo espera a reconciliação do anterior.

Mantenha a aprovação no FloFi

Descubra as capacidades atuais e monte uma estratégia suportada.
Valide e, se quiser, obtenha uma prévia de simulação somente leitura.
Peça uma passagem de aprovação para o hash exato da estratégia.
O dono usa a tela de assinatura dentro do MCP Apps quando o app e a carteira suportam, prova que a carteira é dele, revisa a simulação nova e confirma na carteira. Abrir a página de assinatura do FloFi é uma alternativa externa opcional; o Canvas é opcional.

O modelo não tem autoridade financeiraOAuth, uma conta MCP e um link de aprovação não conseguem assinar, enviar nem aprovar um Manifest. Passagens para mainnet vêm desativadas por padrão e exigem uma política própria do operador.

Veja o guia principal do operador, linkado abaixo, para as variáveis da implantação e o passo a passo completo de conexão do cliente.

O que acontece dentro de cada chat

O MCP App pode embutir a tela de assinatura existente na conversa. Isso exige que o app permita o quadro do FloFi e que a carteira ofereça um provedor compatível ali. Uma mensagem do modelo nunca dá autoridade financeira. O suporte real do app e da carteira precisa ser verificado; uma alternativa externa não é conclusão dentro do chat.

ChatGPT (MCP)

Montagem no chat: Sim. Seu assistente interpreta o pedido; compose_strategy, validate_strategy e review_strategy montam e checam o fluxo canônico.
Simulação no chat: Sim. simulate_strategy roda a prévia somente leitura do fluxo para um endereço público que você indicar: nada é salvo e não dá nenhuma autoridade.
Acompanhamento no chat: Sim. O painel do FloFi acompanha a aprovação e as execuções e informa status e evidências na conversa; sem MCP Apps, peça get_approval_status.
Onde assina: Sua própria carteira, pela tela de assinatura do FloFi, embutida no MCP Apps quando o app permite o quadro do FloFi e a carteira oferece um provedor compatível ali. Abrir o FloFi é uma alternativa externa opcional; o Canvas é opcional. O suporte real do app e da carteira precisa ser verificado.
Redes e ações: Consultado ao vivo com get_supported_networks e get_capabilities; envios para mainnet só nas redes que o operador listar.
Disponibilidade: Um conector personalizado no modo Desenvolvedor, com OAuth do FloFi.

Claude (MCP)

Montagem no chat: Sim. Seu assistente interpreta o pedido; compose_strategy, validate_strategy e review_strategy montam e checam o fluxo canônico.
Simulação no chat: Sim. simulate_strategy roda a prévia somente leitura do fluxo para um endereço público que você indicar: nada é salvo e não dá nenhuma autoridade.
Acompanhamento no chat: Sim. O painel do FloFi acompanha a aprovação e as execuções e informa status e evidências na conversa; sem MCP Apps, peça get_approval_status.
Onde assina: Sua própria carteira, pela tela de assinatura do FloFi, embutida no MCP Apps quando o app permite o quadro do FloFi e a carteira oferece um provedor compatível ali. Abrir o FloFi é uma alternativa externa opcional; o Canvas é opcional. O suporte real do app e da carteira precisa ser verificado.
Redes e ações: Consultado ao vivo com get_supported_networks e get_capabilities; envios para mainnet só nas redes que o operador listar.
Disponibilidade: Um conector personalizado, com OAuth do FloFi.

Telegram

Montagem no chat: Sim. Comandos exatos sempre; linguagem natural quando o intérprete Copilot da implantação está ativo (FLOFI_CHANNEL_COPILOT).
Simulação no chat: Sim, quando ativo (FLOFI_CHANNEL_SIMULATION): uma prévia somente leitura antes do link, se não precisar de conta ou se a estratégia indicar qual ler.
Acompanhamento no chat: STATUS a qualquer momento; avisos de “carregado”, “iniciado” e “reconciliado” depois que você compartilha o status no FloFi (desligado por padrão).
Onde assina: Sua carteira, no FloFi. Abrir o FloFi mostra o fluxo no Canvas; o Telegram não tem assinador de carteira, e nenhuma mensagem (“sim”, “confirmo”) autoriza nada.
Redes e ações: A mesma gramática de estratégias; a política do canal decide fundos de teste e mainnets (nenhuma, a menos que o operador liste).
Disponibilidade: O bot do FloFi, com o webhook verificado da implantação.

WhatsApp

Montagem no chat: Sim. Comandos exatos sempre; linguagem natural quando o intérprete Copilot da implantação está ativo (FLOFI_CHANNEL_COPILOT).
Simulação no chat: Sim, quando ativo (FLOFI_CHANNEL_SIMULATION): uma prévia somente leitura antes do link, se não precisar de conta ou se a estratégia indicar qual ler.
Acompanhamento no chat: STATUS a qualquer momento; avisos de “carregado”, “iniciado” e “reconciliado” depois que você compartilha o status no FloFi (desligado por padrão).
Onde assina: Sua carteira, no FloFi. Abrir o FloFi mostra o fluxo no Canvas; o WhatsApp não tem assinador de carteira, e nenhuma mensagem (“sim”, “confirmo”) autoriza nada.
Redes e ações: A mesma gramática de estratégias; a política do canal decide fundos de teste e mainnets (nenhuma, a menos que o operador liste).
Disponibilidade: Ainda não está no ar: bloqueado até o dono registrar a liberação da política do provedor (WHATSAPP_POLICY_CLEARANCE).

Execução sem abrir o FloFiA tela embutida reaproveita carteira, simulação, revisão, execução e reconciliação. A Phantom não funciona dentro de iframes; outras carteiras e as políticas de sandbox de cada app exigem aceitação ao vivo. Não há retransmissão remota de carteira nem nova delegação permanente.

Capacidades privadas e recuperação

URLs privadas de aprovação chegam à interface do cliente nos metadados da ferramenta, em _meta["flofi/approval"]. O texto para o modelo e os resultados estruturados recebem só uma referência não secreta /approve#apr_…, que funciona apenas na sessão logada do navegador da conta OAuth que a criou. Não copie uma capacidade privada para um prompt ou log do servidor.

A janela de assinatura oferece alternativas privadas e ações para carteiras de celular. A recuperação de uma sessão já usada só restaura a criação do fluxo e ainda exige simulação nova, revisão explícita do Manifest e autorização do dono. Veja Autorização na carteira para a jornada compartilhada.

Fontes: docs/deploy/MCP.md · docs/deploy/UNIVERSAL-SIGNING.md · docs/STATUS.md · apps/reference-dapp/src/app/api/mcp/route.ts · apps/reference-dapp/src/platform/channel-capabilities.ts