🤖 PROTOCOLO DE CONTEXTO DE MODELO (MCP)

Como Conectar Agentes de IA ao FlowOS via MCP

O Model Context Protocol (MCP) é o padrão aberto que permite a LLMs como Claude, GPT e Cursor interagir diretamente com ferramentas externas. Use este guia para equipar sua IA com poderes de WhatsApp.

1. O que é o MCP do FlowOS?

O FlowOS implementa o protocolo MCP oficial disponibilizando um manifesto estruturado em https://flowos.top/docs/mcp.json. Através dele, agentes de IA podem:

Enviar mensagens e lembretes com atrasos inteligentes anti-bloqueio;
Consultar o histórico e estágio do lead no CRM Kanban;
Mover leads entre colunas do funil automaticamente;
Gerar chaves PIX de pagamento Mercado Pago sob demanda;
Extrair contatos locais no Google Maps por nicho e cidade.

2. Configuração no Claude Desktop

Para adicionar o FlowOS ao seu Claude Desktop, abra o arquivo de configuração claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione o servidor FlowOS no bloco mcpServers:

{
  "mcpServers": {
    "flowos": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-fetch",
        "https://flowos.top/docs/mcp.json"
      ],
      "env": {
        "FLOWOS_API_KEY": "SEU_TOKEN_AQUI"
      }
    }
  }
}

3. Configuração no Cursor IDE

No Cursor, crie ou edite o arquivo .cursor/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "flowos": {
      "url": "https://flowos.top/docs/mcp.json",
      "headers": {
        "Authorization": "Bearer SEU_TOKEN_AQUI"
      }
    }
  }
}

Após salvar, recarregue a janela do Cursor e o agente poderá disparar mensagens e atualizar o CRM diretamente da caixa de chat.

4. Uso no LangChain e Python

Você pode conectar o FlowOS aos seus grafos LangGraph ou chains LangChain via HTTP:

import requests

MCP_MANIFEST_URL = "https://flowos.top/docs/mcp.json"
FLOWOS_API_KEY = "SEU_TOKEN_FLOWOS"

# Carrega ferramentas disponíveis
manifest = requests.get(MCP_MANIFEST_URL).json()
print("Ferramentas disponíveis:", [t["name"] for t in manifest["tools"]])

# Execução da ferramenta flowos_send_message
def send_whatsapp(phone, message):
    return requests.post(
        "https://flowos.top/api/flows/trigger",
        headers={"Authorization": f"Bearer {FLOWOS_API_KEY}"},
        json={"phone": phone, "message": message}
    ).json()