Configuração do MCP

Endpoint

https://www.fuxux.com/api/mcp

Streamable HTTP sem estado: envie JSON-RPC com POST. Não há stream SSE, então GET retorna 405.

Autenticação

Há duas formas de conectar. Use a que o seu cliente suportar.

Login (sem chave)

Adicione o endpoint acima sem cabeçalho. O cliente abre o Fuxux no seu navegador, você faz login e escolhe Allow access, e a conexão é feita. Nada é colado no chat.

• O app pode usar as ferramentas desta página e nada mais. Ele nunca vê a sua senha e não pode alterar o seu plano, o faturamento nem as contas conectadas.
• Remova um app a qualquer momento em Settings, em Connected apps. Ele para de funcionar na hora.
• Para desenvolvedores de clientes: autorização MCP padrão (OAuth 2.1 com PKCE). Os metadados do servidor estão em /.well-known/oauth-authorization-server; Client ID Metadata Documents e o registro dinâmico de clientes são suportados; os tokens de acesso duram uma hora e são renovados.

Chave de API

Envie a sua chave em toda requisição:

Authorization: Bearer fx_live_your_key_here

Clientes que conseguem definir um cabeçalho, mas não adicionar o prefixo Bearer, podem enviar x-api-key: fx_live_… no lugar. Guarde as chaves em variáveis de ambiente ou no cofre de segredos do seu cliente, nunca em arquivos de configuração compartilhados.

Claude (web, desktop e celular)

1. No Claude, abra Settings, depois Connectors, e adicione um conector personalizado.
2. Dê o nome Fuxux e cole o endpoint: https://www.fuxux.com/api/mcp
3. Escolha Connect, faça login no Fuxux se for pedido e escolha Allow access.

ChatGPT

O Fuxux está no diretório de plugins do ChatGPT. Abra o plugin do Fuxux (ou procure Fuxux em Plugins), escolha Install plugin, depois Connect Fuxux, faça login e escolha Allow access.

Ou adicione manualmente como servidor MCP personalizado (exige um plano pago do ChatGPT, na web):

1. No ChatGPT, abra Plugins, escolha Add, depois Create custom MCP server.
2. Dê o nome Fuxux, cole a URL do servidor https://www.fuxux.com/api/mcp e deixe Authentication em OAuth.
3. Marque a confirmação, crie o servidor, escolha Continue to Fuxux, faça login se for pedido e escolha Allow access.
4. Abra o plugin do Fuxux e escolha Try in chat ou mencione @Fuxux em uma mensagem.

Claude Code

Para fazer login, adicione o servidor sem cabeçalho:

claude mcp add --transport http fuxux https://www.fuxux.com/api/mcp

Depois rode /mcp dentro do Claude Code, escolha fuxux e faça a autenticação no navegador.

Ou, com uma chave de API, adicione o servidor pelo terminal:

claude mcp add --transport http fuxux https://www.fuxux.com/api/mcp --header "Authorization: Bearer $FUXUX_API_KEY"

Ou compartilhe com um projeto em .mcp.json na raiz do repositório (o Claude Code expande ${VAR} a partir do seu ambiente):

{
  "mcpServers": {
    "fuxux": {
      "type": "http",
      "url": "https://www.fuxux.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${FUXUX_API_KEY}"
      }
    }
  }
}

Cursor (em um clique)

Defina uma variável de ambiente com a sua chave de API do Fuxux:

FUXUX_API_KEY=fx_live_your_key_here

O Cursor expande ${env:NAME} em mcp.json (veja a documentação de MCP do Cursor). Depois adicione o servidor:

Ou adicione manualmente em ~/.cursor/mcp.json ou no .cursor/mcp.json de um projeto:

{
  "mcpServers": {
    "fuxux": {
      "url": "https://www.fuxux.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:FUXUX_API_KEY}"
      }
    }
  }
}

Claude Desktop e outros clientes só stdio

Use a ponte mcp-remote (precisa de Node.js) em claude_desktop_config.json. Manter o cabeçalho em env evita um problema conhecido com espaços nos argumentos no Windows:

{
  "mcpServers": {
    "fuxux": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.fuxux.com/api/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer fx_live_your_key_here"
      }
    }
  }
}

Manus e Cue

Adicione o Fuxux como conector Custom MCP com o endpoint acima e um cabeçalho Authorization. Os valores passo a passo e uma nota de conector pronta estão no guia do Cue & Manus.

Ferramentas

• whoami — verifica se a conexão funciona e lê o seu e-mail e plano
• list_connected_accounts — suas contas sociais conectadas, com os ids que os targets de create_post usam
• get_dashboard — estatísticas, próximos posts e contas que precisam de atenção
• list_posts — a fila: opcionais month, status (scheduled, published, draft, failed), limit (1–50, padrão 20), offset e order (upcoming, newest, recently_published, recently_updated)
• create_post — publica agora, agenda com scheduled_at ou salva um rascunho com draft: true. Passe targets para escolher as contas; caso contrário, cada plataforma posta na primeira conta conectada. O Reddit não é suportado.
• get_post — um post com as variantes por plataforma (inclusive rascunhos)
• update_post — reagenda, edita legendas ou substitui mídias de um rascunho ou post agendado
• delete_post — exclui um post do Fuxux (não remove nada que já foi publicado na plataforma)

Ids de plataforma para captions e targets:

twitterinstagramlinkedinfacebooktiktokyoutubeblueskythreadspinterestdiscordkicktwitchtelegramslack

Faturamento, gerenciamento de chaves de API, webhooks, equipes e configurações da conta não estão disponíveis como ferramentas. Os equivalentes REST das ferramentas estão na referência da API.

Limites e bom comportamento do agente

• 120 requisições por minuto por chave e 300 por minuto por conta, somando todas as suas chaves e apps conectados por login. Acima do limite, as ferramentas dizem quantos segundos esperar.
• Não faça polling. A publicação se resolve em minutos, então verifique o status de um post com get_post no máximo uma vez por minuto.
• Quando uma regra da plataforma bloqueia um post (por exemplo, o Instagram exige uma imagem ou um vídeo), a ferramenta retorna o motivo como um erro com o qual o agente pode agir.

Solução de problemas

• "Missing or invalid Authorization" / 401: a chave foi revogada, rotacionada ou digitada errado. Crie uma nova e confira o prefixo Bearer e o espaço.
• 401 depois de fazer login: o acesso do app expirou ou foi removido em Settings. Conecte de novo.
• 401 com uma chave de API: a chave está errada ou revogada, ou a sua conta não tem plano pago. Confira o seu plano antes de criar uma chave nova. A regra do plano pago vale para chaves de API, não para o login.
• "Connect at least one account": nenhuma das plataformas em captions tem uma conta conectada. Quando só algumas faltam, elas são ignoradas: compare o resultado com as plataformas que você enviou.
• Limite de requisições: espere os segundos que a ferramenta informar e garanta que o agente não esteja verificando o status em loop.