grok mcp add) nem as tools de Remote MCP da API da xAI. São produtos separados.
O PostClean não está entre os conectores nativos nem no catálogo do Grok. Você mesmo o adiciona: New Connector → Custom e cola a URL MCP do PostClean.
Pré-requisitos
- Uma conta no Grok. A xAI informa que os conectores estão disponíveis para todos os usuários do Grok.
- Uma conta ativa no PostClean
- No Grok Business ou Enterprise, um administrador do time precisa liberar o conector antes. Veja Grok Business e Enterprise
URL do servidor
Use exatamente esta URL. Não coloque barra no final. Não cole uma URL de autorização OAuth.Configuração
1
Abra os Connectors
Na web, acesse grok.com/connectors.Você também pode começar por uma conversa: clique em + → Connectors → + Add connector.No iOS e no Android, abra Settings → Connectors.
2
Adicione um conector personalizado
Clique em New Connector e escolha Custom.Cole a URL do servidor MCP:Se o Grok pedir um nome, use
PostClean.Se o Grok mostrar campos de cliente OAuth (Client ID, Client Secret, URLs de authorize/token), deixe em branco. O PostClean usa OAuth 2.1 com Dynamic Client Registration. O Grok descobre os endpoints pela URL MCP e se registra sozinho.3
Entre no PostClean
Em seguida, o Grok pede que você se autentique. Conclua o login no navegador:
- Entre na sua conta do PostClean
- Confira as permissões
- Escolha o Workspace que essa conexão pode usar e clique em Autorizar (para usar outro workspace, conecte de novo e escolha-o)
4
Peça ao Grok para usar o PostClean
Abra uma nova conversa e peça em linguagem natural. Por exemplo:O Grok deve chamar as tools do PostClean em vez de inventar a resposta. Se ele responder sem usar as tools, diga que quer que ele use o conector PostClean.Veja a referência de tools com todas as tools e o fluxo recomendado (escolher o canal e o tipo de conteúdo, criar com mídia, pré-visualizar, publicar).
Autenticação
O MCP do PostClean aceita somente OAuth: um login no navegador com o escopomcp:use. Os Personal Access Tokens criados em Configurações → API Keys funcionam na API REST, não em /mcp/trypost.
Depois, você gerencia os assistentes conectados em Configurações → MCP do workspace no PostClean.
O que você pode fazer
Com o conector autorizado, o Grok consegue:
Algumas dessas ações dependem das suas permissões no workspace (aprovar exige publicação direta; horários de postagem, webhooks e chaves de API exigem administrador). Veja as permissões na introdução.
O Pinterest precisa de um
board_id, o Discord de um channel_id e o TikTok de um privacy_level antes de publicar. Peça ao Grok para listar os boards ou canais primeiro. Detalhes e nomes das tools: referência de tools.
Grok Business e Enterprise
Nesses planos, os membros só conseguem adicionar um conector personalizado depois que um administrador do time o libera.Administrador: libere o PostClean para o time
Administrador: libere o PostClean para o time
- Entre em console.x.ai, selecione o time e abra Grok Business → Connectors
- Clique em + Add Connector → Other
- Cole
https://post.chatclean.com.br/mcp/trypost - Conclua o login no PostClean se o Grok pedir
Solução de problemas
O Grok nunca pede para eu entrar no PostClean
O Grok nunca pede para eu entrar no PostClean
Talvez você tenha colado a URL errada. Use
https://post.chatclean.com.br/mcp/trypost, e não /oauth/authorize, nem /api, nem com barra no final. Remova o conector, adicione de novo e permita pop-ups para a janela do OAuth poder abrir.O conector foi adicionado, mas o Grok não chama as tools do PostClean
O conector foi adicionado, mas o Grok não chama as tools do PostClean
Conclua o OAuth. O Grok pode listar um servidor personalizado antes de você autorizá-lo. Abra grok.com/connectors, conecte o PostClean, escolha o workspace e clique em Autorizar na tela do PostClean. Depois comece uma conversa nova e peça para ele usar o conector do PostClean.
O Grok diz que não consegue acessar o servidor
O Grok diz que não consegue acessar o servidor
O Grok acessa o servidor MCP a partir da nuvem da xAI. O endpoint do PostClean é público, então confira se a URL está exatamente como acima. Se o erro continuar, fale com o suporte.
HTTP 402: Active subscription required
HTTP 402: Active subscription required
A autorização OAuth funcionou, mas a conta do PostClean não está ativa. Abra o PostClean, ative a assinatura e reconecte o conector. Veja a introdução.
HTTP 401 ou preciso entrar de novo
HTTP 401 ou preciso entrar de novo
A sessão OAuth expirou ou foi revogada. Abra o conector e faça o login de novo.
A opção Custom não aparece ou não consigo adicionar um conector
A opção Custom não aparece ou não consigo adicionar um conector
No Grok Business / Enterprise, só um administrador pode liberar MCP personalizado. Peça a alguém com Team Read-Write para adicionar o PostClean em console.x.ai primeiro. No Grok pessoal, abra grok.com/connectors e escolha Custom, e não um app do catálogo.
Exemplos de prompts
Relacionados
- Introdução: visão geral do MCP, autenticação e solução de problemas em comum
- Referência de tools: todas as tools, parâmetros e o fluxo de publicação
- xAI: conectores do Grok: passo a passo oficial de MCP personalizado