O Model Context Protocol (MCP) é a camada de conexão entre clientes de IA (Claude Code, Cursor, assistentes desktop estilo ChatGPT) e ferramentas externas. O OmniGems entrega um servidor MCP oficial para que criadores e operadores possam rodar todo o seu pipeline de influenciadores IA — agentes, posts, geração de conteúdo, saldo, fluxos Camunda — de dentro da ferramenta de IA que já usam para pensar e codar.
Este guia é a configuração de trabalho e a referência. Cobre o que o MCP do OmniGems expõe, o fluxo OAuth 2.1, as 16 ferramentas (leitura + escrita), workflows reais que se acumulam e a postura de segurança que todo operador deve entender antes de apontar um cliente novo para dados de produção.
Por que MCP para operações de influenciadores IA
Três motivos pelos quais a integração MCP muda o workflow diário no OmniGems AI:
- Sem troca de contexto. Os operadores já vivem no Claude Code ou Cursor para prompt engineering, pesquisa e scripts de conteúdo. Adicionar «monitorar agentes», «enfileirar posts» e «estimar custo» como ferramentas dentro do editor elimina a alternância entre abas que destrói o foco.
- Operações em linguagem natural. «Mostre-me os três posts de melhor desempenho do agente @miami_condos esta semana e depois agende uma atualização de mercado para a próxima segunda» é um único turno de chat em vez de uma travessia de UI por 6 telas.
- Programável a partir de qualquer cliente. Claude Code hoje, Cursor hoje, ChatGPT desktop amanhã — as mesmas ferramentas estão disponíveis em qualquer lugar onde MCP seja suportado.
Para o playbook mais amplo sobre operações de influenciadores IA, veja How to Create an AI Influencer. Para agentes de postagem multi-plataforma, veja How AI Agents Post on Social Media.
O que o OmniGems MCP expõe
O servidor fala versão do protocolo MCP 2024-11-05 sobre JSON-RPC 2.0 e registra 16 ferramentas em dois scopes:
Scope de leitura — mcp:read
| Ferramenta | O que faz |
|---|---|
| viral_list_agents | Lista seus agentes (id, username, nível, contagem de posts, tags) |
| viral_get_agent | Detalhes completos do agente incluindo configuração de persona |
| viral_list_posts | Lista posts com filtros; ordena por burns para os melhores |
| viral_get_post | Post completo — texto, mídia, plataformas, totais de boost |
| viral_activity_daily | Queima diária de BURNS por boost em 7 dias + contagem de influenciadores ativos |
| viral_active_processes | Workflows virais Camunda em andamento para um agente |
| viral_list_user_tasks | Tarefas de usuário aguardando intervenção humana |
| viral_get_process_status | Snapshot de status de um processo Camunda específico |
| viral_get_balance | Saldo atual da conta e holdings de BURNS |
| viral_estimate_cost | Estimativa de custo para uma solicitação de geração de conteúdo |
| viral_parse_influencer_description | Converte prompts de persona em texto livre em configuração estruturada |
Scope de escrita — mcp:write
| Ferramenta | O que faz |
|---|---|
| viral_cancel_process | Cancela um workflow de geração em andamento |
| viral_complete_user_task | Envia entrada para uma tarefa de usuário pausada no workflow |
| viral_upload_media_from_url | Faz upload de imagens / vídeo de referência via URL |
| viral_create_influencer | Lança uma nova persona IA com configuração completa |
| viral_start_content | Inicia a geração de conteúdo para um agente |
Cada ferramenta retorna tanto content[0].text legível por humanos quanto structuredContent legível por máquinas, de modo que qualquer cliente — estilo chat ou agente de código — possa fazer o parse da resposta de forma limpa.
Início rápido: Claude Code
O caminho mais rápido. Do seu terminal:
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp
A primeira chamada abre um navegador e o conduz pelo fluxo OAuth:
- Login — entrada com carteira Web3 se você ainda não estiver autenticado
- Consentimento — confirme o scope (
mcp:read,mcp:read mcp:writese escritas forem solicitadas) - Troca de token — o Claude Code armazena access + refresh tokens localmente e os rotaciona automaticamente
Depois disso, cada sessão do Claude Code tem acesso às ferramentas OmniGems sem reautenticar até que o TTL de 30 dias do refresh token expire. Para Cursor ou outro cliente MCP, a URL é a mesma; o registro é dinâmico segundo a RFC 7591, então cada cliente recebe seu próprio client_id.
O fluxo de auth OAuth 2.1 + PKCE
O modelo de autenticação é intencionalmente rigoroso porque os tokens desbloqueiam dinheiro real — gerações pagas, operações de saldo, agentes de postagem. O fluxo completo:
| Passo | Endpoint | Spec |
|---|---|---|
| Discovery | GET /.well-known/oauth-authorization-server | RFC 8414 |
| Metadados do recurso | GET /.well-known/oauth-protected-resource | RFC 9728 |
| Registro dinâmico de cliente | POST /api/oauth/register | RFC 7591 |
| Authorize (PKCE S256) | GET /api/oauth/authorize | OAuth 2.1 |
| Token / refresh | POST /api/oauth/token | OAuth 2.1 |
| Revocation | POST /api/oauth/revoke | RFC 7009 |
Detalhes que importam para revisão de segurança:
- Os access tokens são JWTs (24h) com uma claim
jti; a revogação grava uma entrada de denylist válida até a expiração natural do JWT. - Os refresh tokens são opacos (com Redis no backend, TTL de 30 d) e rotacionados ao uso. Reutilizar um refresh token antigo retorna
invalid_grant. - PKCE S256 é obrigatório. Códigos de auth são de uso único, TTL de 60 segundos.
- Apenas clientes públicos —
token_endpoint_auth_method: "none". Sem segredos compartilhados para vazar. - Loopback + HTTPS + private-use URI schemes são os únicos padrões aceitos de
redirect_uri. - Registro dinâmico de clientes tem rate limit de 20/h por IP.
- Usuários com
is_block: truesão rejeitados tanto em/authorizequanto em/api/mcp. - Rate limits do MCP: 120 requisições/min por usuário no geral, 20/min especificamente para ferramentas
mcp:write.
Cinco workflows que se acumulam
Estes são os padrões de workflow que justificam conectar o MCP ao seu cliente diário. Todos funcionam no Claude Code; a maioria funciona em qualquer cliente compatível com MCP.
1. Standup diário
«Mostre-me os 3 melhores posts de ontem em todos os meus agentes, os workflows em andamento e qualquer tarefa de usuário esperando por mim.»
Três chamadas de ferramentas — viral_activity_daily, viral_active_processes, viral_list_user_tasks — compostas pelo cliente IA em um único relatório matinal.
2. Lançamento de persona
«Crie uma nova persona IA para o nicho de imóveis de Coral Gables, corretora licenciada com 30 e poucos anos, voz estilo podcast, inglês + espanhol.»
O cliente converte o texto livre em configuração estruturada via viral_parse_influencer_description, estima custo via viral_estimate_cost, depois confirma via viral_create_influencer. Três chamadas de ferramentas, um turno de chat.
3. Lote de conteúdo
«Estime o custo de 10 clips short-form para @luna_design e depois enfileire-os com hooks baseados no post de melhor desempenho desta semana.»
viral_get_post (top performer) → viral_estimate_cost → viral_start_content. O cliente IA fornece os hooks; o MCP fornece a orquestração.
4. Guard-rails de custo
«Se meu saldo cair abaixo de 1000 BURNS, cancele quaisquer gerações long-form em andamento e me notifique.»
viral_get_balance + viral_active_processes + viral_cancel_process. Conecte como um hook do Claude Code para verificações periódicas.
5. Repasse para revisor humano
«Liste todas as tarefas de usuário pausadas para @miami_condos. Para a mais antiga, mostre-me os campos do formulário, redija uma resposta na minha voz e envie após minha aprovação.»
viral_list_user_tasks → viral_get_process_status → viral_complete_user_task. O cliente IA redige; o humano aprova; o MCP confirma.
Para a economia mais ampla de BURNS, veja BURNS Token Glossary. Para a mecânica de tokenomics, veja Tokenomics Guide.
Arquitetura: como as requisições são escopadas
Toda chamada MCP é escopada ao usuário autenticado. Os handlers de ferramentas não encaminham o JWT da carteira do usuário para serviços internos — eles chamam o Flow API diretamente com uma chave de sistema do lado do servidor mais o user_id extraído do bearer token verificado. As consultas de cada ferramenta são escopadas a esse user_id / webapp_user_id no servidor. Não há caminho onde a sessão MCP de um usuário possa ler agentes, posts ou saldo de outro.
O mesmo escopo se aplica às escritas — viral_create_influencer e viral_start_content sempre criam recursos pertencentes ao chamador; viral_cancel_process só tem sucesso para processos que o chamador iniciou.
Construindo seu próprio workflow guiado por MCP
O MCP é mais útil quando você para de usá-lo como substituto de chat para o dashboard e começa a usá-lo como um substrato programável. Alguns padrões que vimos criadores usarem:
- Monitores estilo cron — uma sessão do Claude Code que acorda a cada hora, roda
viral_activity_daily+viral_get_balancee te avisa só quando um limite é violado - Portfólios de personas — um cliente IA gerencia 5–10 personas em sub-nichos adjacentes via comandos em linguagem natural em vez de clicar 50 vezes por dia em um dashboard
- Coordenação cross-cliente — Cursor para scripts de conteúdo + Claude Code para ops. Ambos autenticam no mesmo servidor MCP com seus próprios clientes; os agentes e posts subjacentes são compartilhados
- Auditorias de compliance — um script one-shot que puxa todo post publicado via
viral_list_postse roda checagem de disclosure contra uma rubrica interna antes de uma revisão regulatória
Para a camada de seleção de nicho que deve ficar acima de qualquer um destes workflows, veja Best AI Influencer Niches.
Roadmap
A versão atual do protocolo MCP 2024-11-05 é a base estável. O servidor OmniGems é construído para acompanhar a spec — saltos de protocolo aterrissam primeiro em canary, depois se graduam para produção em 2 semanas após o release. A superfície de ferramentas cresce mensalmente; as adições recentes (ferramentas de scope de escrita chegaram no fim de 2025) cobrem criação de persona e início de conteúdo, com planos para ferramentas só de analytics e compartilhamento em escopo de equipe nos próximos releases.
Se você tem uma ferramenta específica que quer ver exposta, o fluxo canônico de pedido é abrir um issue contra a spec open-source da ferramenta — o time prioriza por demanda e por contratos input/output claros.
Como começar
- Instale Claude Code, Cursor ou qualquer cliente compatível com MCP
- Rode
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp(ou o equivalente no seu cliente) - Faça o fluxo OAuth — entre com sua carteira Web3, aprove os scopes solicitados
- Tente
tools/listpara ver as 16 ferramentas que seu token pode invocar - Comece com
viral_activity_dailypara confirmar a conexão - Adicione workflows a partir dos padrões acima
O MCP é o caminho mais direto entre o cliente de IA no qual você já pensa e o pipeline de influenciadores IA que move seu negócio. Quanto mais você empurrar suas operações diárias para a mesma ferramenta com a qual raciocina, mais rápido tudo se acumula.
O que ler em seguida
- How to Create an AI Influencer — passo a passo completo de lançamento
- How AI Agents Post on Social Media — agentes de postagem multi-plataforma
- Best AI Influencer Niches — framework de seleção de nicho
- BURNS Token Glossary — a economia do token que sustenta
viral_get_balanceeviral_estimate_cost - Tokenomics Guide — bonding curves e mecânica de holders