MCP

Conecte clientes de IA compatíveis com MCP ao Fluxo para que os agentes possam ler o contexto de suporte a que a pessoa do seu time com sessão iniciada já tem acesso.

Endpoint:

Copiarhttps://api.fluxo.lat/mcp

O servidor MCP hospedado usa MCP por HTTP remoto com OAuth. O seu cliente abrirá um login no navegador quando for preciso autenticar. Não cole uma chave de API do Fluxo, um token bearer nem um segredo de cliente na configuração do MCP.

O acesso é limitado à sua conta do Fluxo. Os agentes só podem ler os sites e os dados de suporte disponíveis para a pessoa que fizer login. O OAuth solicita o escopo support:read.

Instalação

Cursor

Crie ou atualize .cursor/mcp.json no seu projeto, ou ~/.cursor/mcp.json para uma configuração global:

Copiar{
  "mcpServers": {
    "fluxo": {
      "url": "https://api.fluxo.lat/mcp"
    }
  }
}

Reinicie o Cursor ou recarregue o MCP depois de salvar o arquivo. Quando o Cursor pedir autenticação, conclua o login no navegador.

Claude Code

Copiarclaude mcp add --transport http fluxo https://api.fluxo.lat/mcp

Depois abra o Claude Code e execute:

Copiar/mcp

Use a visão de status do MCP para se autenticar no Fluxo pelo navegador.

OpenCode

Adicione o Fluxo ao opencode.json:

Copiar{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "fluxo": {
      "type": "remote",
      "url": "https://api.fluxo.lat/mcp",
      "enabled": true
    }
  }
}

Reinicie o OpenCode ou recarregue o MCP para que ele descubra o novo servidor.

Manual

Para clientes que aceitam um objeto mcpServers, use:

Copiar{
  "mcpServers": {
    "fluxo": {
      "type": "http",
      "url": "https://api.fluxo.lat/mcp"
    }
  }
}

Alguns clientes chamam o transporte HTTP remoto de streamable-http. Mantenha a mesma URL se o seu cliente usar esse nome.

O que os agentes podem fazer

As primeiras ferramentas MCP do Fluxo são somente leitura:

Ferramentas de escrita como responder, resolver ou mudar a prioridade ainda não são expostas.

Entradas e saídas das ferramentas

Selecione um site com exatamente um entre websiteId ou o websiteName exato em todas as ferramentas, exceto fluxo_list_websites.

Os erros das ferramentas são devolvidos como erros MCP, sem detalhes internos do banco de dados. Um seletor de site ausente ou ambíguo, um recurso inacessível, um cursor inválido ou uma sessão OAuth expirada devem ser corrigidos, não repetidos às cegas.

No momento, o endpoint hospedado permite 60 requisições HTTP de MCP por minuto por IP ou sujeito autenticado. Respeite os cabeçalhos de limite de uso e tente de novo após a janela indicada pelo servidor; não execute paginação paralela sem limite.

Experimente

Peça ao seu agente:

CopiarList my Fluxo websites.

CopiarSearch Acme Support knowledge for billing cancellation.

CopiarShow recent open conversations for Acme Support.

CopiarOpen conversation <conversationId> and summarize the latest customer issue.

Solução de problemas

• Reconecte ou recarregue o MCP depois de editar a configuração.
• Use a visão de status do MCP do seu cliente para concluir o OAuth.
• Confirme que você entrou com uma conta do Fluxo que tem acesso ao site.
• Remova qualquer cabeçalho Authorization se o OAuth não iniciar.
• No OpenCode, use opencode mcp list, opencode mcp debug e opencode mcp logout fluxo para inspecionar ou limpar a autenticação.
• No Claude Code, abra /mcp para inspecionar o servidor e limpar ou refazer a autenticação.
• No Cursor, use os controles de status e login do MCP depois de recarregar a configuração.
• Revogue o acesso encerrando a sessão do servidor do Fluxo no cliente ou revogando a sessão OAuth correspondente nas configurações de segurança da sua conta.