Servidor MCP do Semurai: conecte Claude e ChatGPT

MCP (Model Context Protocol) é o padrão aberto que os assistentes de IA usam para se conectar a outros apps. Você adiciona um endereço no seu assistente, aprova a conexão uma vez e, a partir daí, pede trabalho de SEO e de conteúdo no mesmo chat que já usa. Uma visão geral do que isso oferece está na página Servidor MCP do Semurai.

O que você pode fazer

Escreva com suas próprias palavras. O assistente escolhe as ações certas do Semurai, trabalha no seu espaço de trabalho e conta o que fez. Alguns exemplos por área:

Pesquisa de SEO

Pesquisa de palavras-chave e palavras-chave relacionadas, análise de concorrentes e lacunas de palavras-chave, quem aparece para uma busca, visão geral de um domínio, verificação de posições em tempo real e clusters de tópicos. Saiba mais em Pesquisa de palavras-chave.

Encontre palavras-chave de cauda longa sobre café cold brew com baixa dificuldade.
Para quais palavras-chave meus concorrentes ranqueiam e nós não?
Monte um cluster de tópicos sobre espresso em casa.

Posições e Search Console

Palavras-chave monitoradas e o histórico das posições, novas palavras-chave para monitorar, relatórios do Google Search Console (visão geral, principais consultas, principais páginas, tendências de consultas e oportunidades), auditorias de páginas, auditorias completas do site e relatórios de desempenho.

Como nossas palavras-chave monitoradas se moveram este mês?
Mostre as consultas do Search Console com muitas impressões e CTR baixo.
Faça uma auditoria de SEO completa do nosso site e liste as correções mais importantes.

Conteúdo

Busque e leia seus artigos e documentos, crie estruturas, escreva artigos de SEO com espaços reservados para imagens, atualize conteúdos, crie documentos e rascunhos de e-mail, planeje conteúdo e campanhas, encontre datas de marketing e receba sugestões de links internos.

Escreva um artigo de SEO sobre como escolher um moedor de café, com base na nossa pesquisa de palavras-chave.
Planeje um mês de conteúdo para o blog da nossa loja.
Sugira links internos para o artigo sobre máquinas de espresso.

Redes sociais e calendário

Rascunhos de posts para redes sociais (texto), a lista dos seus posts, o calendário de conteúdo e o agendamento de conteúdos e posts.

Escreva três posts para o LinkedIn divulgando nosso artigo mais recente.
O que está planejado no calendário de conteúdo para a próxima semana?
Agende o post do LinkedIn sobre o blend de outono para sexta-feira às 9h.

Publicação

Publique artigos no WordPress, no PrestaShop ou no blog da Shoper. No WordPress, o assistente também pode analisar posts e preparar, aplicar ou descartar mudanças de SEO.

Publique o artigo sobre moedores de café no nosso blog da Shoper.
Verifique o SEO dos nossos cinco posts mais recentes do WordPress e prepare correções.

E-commerce

Trabalhe com suas lojas conectadas na Shoper, no WooCommerce e no PrestaShop: busque produtos e categorias, prepare propostas de SEO para produtos, categorias e textos alternativos de imagens, aplique as propostas que você aprovar e importe produtos da Shoper. Saiba mais em Loja.

Encontre produtos sem meta description e prepare propostas de SEO.
Escreva textos alternativos para as imagens da categoria Moedores.
Aplique na loja as propostas aprovadas.

Mídia e tarefas

Busque na biblioteca de mídia, adicione mídia a partir de uma URL, atualize os detalhes e organize pastas. Liste, crie e atualize tarefas e atribua uma tarefa a um dos agentes do Semurai.

Mova as fotos de produto da semana passada para uma pasta Campanha de primavera.
Crie uma tarefa para atualizar o artigo de preços e atribua à Tenko.

Conecte o seu assistente

Todos os assistentes usam o mesmo endereço de servidor. Copie e siga os passos do seu assistente. O mesmo endereço e instruções curtas estão no app do Semurai, em Configurações → Assistentes de IA (MCP).

https://api.semur.ai/mcp

Claude (web e app para desktop)

No Claude, abra Customize → Connectors.
Clique em + Add e escolha Add custom connector.
Digite um nome, por exemplo Semurai, cole o endereço do servidor e clique em Continue e depois em Add.
Clique em Connect e aprove a conexão na página do Semurai.

Nos planos Claude Team e Enterprise, um Owner da organização adiciona o conector uma única vez em Organization settings → Connectors → Add → Custom → Web. Depois, os membros clicam em Connect e entram com suas próprias contas do Semurai. No plano Free você pode adicionar um conector personalizado. O que o Claude pode fazer com o Semurai, com prompts de exemplo: Claude para SEO.

ChatGPT

No ChatGPT na web, abra Plugins e clique em +.
Escolha Add custom MCP server, digite um nome e cole o endereço do servidor.
Na autenticação, escolha OAuth, marque I understand and want to continue e clique em Create.
Aprove a conexão na página do Semurai.

Ações completas (escrita) no ChatGPT: planos Business, Enterprise e Edu. No Pro, servidores MCP personalizados se conectam no modo somente leitura. Servidores MCP personalizados são adicionados no ChatGPT na web. Casos de uso e prompts para testar estão em ChatGPT para SEO.

Claude Code

Execute este comando no terminal:

claude mcp add --transport http --scope user semurai https://api.semur.ai/mcp

A opção --scope user adiciona o Semurai a todos os seus projetos. Depois, entre no Semurai com claude mcp login semurai ou digite /mcp no Claude Code. Trabalho de SEO pelo terminal, com exemplos: Claude Code para SEO.

Codex

Execute este comando no terminal:

codex mcp add semurai --url https://api.semur.ai/mcp

Depois, entre no Semurai com codex mcp login semurai. Você também pode adicionar o servidor em ~/.codex/config.toml:

config.toml

[mcp_servers.semurai]
url = "https://api.semur.ai/mcp"

A extensão do Codex para IDEs e o app do Codex para desktop usam a mesma configuração. Lá você também adiciona o servidor em Settings → MCP servers → Add server, com o tipo Streamable HTTP. Mais sobre como trabalhar com o Semurai no Codex: Codex MCP.

Cursor

Adicione o servidor ao ~/.cursor/mcp.json para usá-lo em todos os projetos, ou ao .cursor/mcp.json de um único projeto:

mcp.json

{
  "mcpServers": {
    "semurai": {
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Entre no Semurai quando o Cursor pedir. O que você pode pedir no Cursor: Cursor MCP.

VS Code (GitHub Copilot)

No modo agente, o GitHub Copilot usa os servidores do .vscode/mcp.json do seu projeto:

.vscode/mcp.json

{
  "servers": {
    "semurai": {
      "type": "http",
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Clique em Start acima do servidor no arquivo e entre no Semurai. Exemplos para o Copilot no modo agente: VS Code MCP.

Outros assistentes

Qualquer assistente compatível com servidores MCP remotos e login OAuth se conecta do mesmo jeito: adicione https://api.semur.ai/mcp como endereço do servidor.

Gemini CLI: adicione o servidor com este comando e depois entre com /mcp auth semurai no Gemini CLI.

gemini mcp add --transport http semurai https://api.semur.ai/mcp

No arquivo settings.json do Gemini CLI, o endereço fica na chave httpUrl:

settings.json

{
  "mcpServers": {
    "semurai": {
      "httpUrl": "https://api.semur.ai/mcp"
    }
  }
}

Servidor completo com artes de IA

O endereço acima é o servidor oficial, o dos diretórios de apps do Claude e do ChatGPT e do trabalho do dia a dia. O Semurai também tem um servidor completo: o mesmo login e as mesmas ferramentas, e ainda artes com IA. Você o adiciona como conector personalizado, com este endereço:

https://api.semur.ai/mcp/full

Com o servidor completo, o seu assistente também pode:

criar imagens para posts nas redes sociais e artigos,
criar designs no Canvas,
criar designs no Creative Studio,
trabalhar nos seus designs do Creative Studio: escolher o modo, responder às perguntas do designer, revisar um design e voltar a uma versão anterior ou a uma variante,
salvar artes para redes sociais, carrosséis e anúncios do Creative Studio na biblioteca de mídia e colocá-los nos seus posts,
sugerir ideias de design para a sua marca,
escrever descrições com IA e textos alternativos para as imagens da sua biblioteca de mídia.

Adicionar o servidor completo

Claude: em Customize → Connectors, clique em + Add, escolha Add custom connector e cole o endereço do servidor completo.
ChatGPT: em Plugins, clique em +, escolha Add custom MCP server e cole o endereço do servidor completo.
Cursor e VS Code: use o mesmo mcp.json mostrado acima, com o endereço do servidor completo.

No Claude Code, execute:

claude mcp add --transport http --scope user semurai-full https://api.semur.ai/mcp/full

No Codex, execute:

codex mcp add semurai-full --url https://api.semur.ai/mcp/full

Uma conexão aprovada para o servidor oficial funciona com o servidor oficial. Para usar o servidor completo, adicione-o como um conector separado e aprove a conexão na página do Semurai. No Claude Code e no Codex, entre com claude mcp login semurai-full ou codex mcp login semurai-full. As artes criadas pelo servidor completo contam para os limites de uso do espaço de trabalho, como as criadas no app.

Primeira conexão e espaços de trabalho

Na primeira conexão, o assistente abre uma página do Semurai. Entre na sua conta, se ainda não tiver entrado, e depois:

Confira o nome do app e o endereço para onde o navegador volta. Os dois aparecem na página.
Escolha o Espaço de trabalho padrão.
Clique em Permitir. O navegador leva você de volta ao assistente, pronto para trabalhar.

O assistente trabalha no espaço de trabalho padrão. Quando você pede, ele lista seus outros espaços de trabalho, trabalha em qualquer um deles e troca o padrão, por exemplo: Quais espaços de trabalho eu tenho? Mude para o espaço de trabalho da loja.

Trabalhos mais longos rodam em segundo plano: escrever um artigo, uma auditoria completa do site, um plano de conteúdo, posts para redes sociais ou um cluster de tópicos. O assistente acompanha o progresso e traz o resultado quando estiver pronto. Os rascunhos aparecem no app do Semurai: na Biblioteca, no calendário de conteúdo e nos seus posts para redes sociais.

Gerenciar e desconectar

No app do Semurai, abra Configurações → Assistentes de IA (MCP). Lá você encontra:

os dois endereços do servidor (oficial e completo) com botões de copiar e instruções curtas para cada assistente,
os apps conectados, com a data da conexão e do último uso de cada um,
o espaço de trabalho padrão de cada app, que você pode mudar a qualquer momento,
Desconectar, que encerra na hora o acesso do app.

Para voltar a usar um assistente desconectado, conecte-o de novo pelo assistente.

Segurança e limites de uso

Você confirma o que sai do Semurai. Publicar ou agendar fora do Semurai (WordPress, o blog do PrestaShop ou da Shoper, redes sociais) e aplicar mudanças em uma loja ou em um site WordPress são ações separadas, e o assistente pede a sua confirmação para cada uma.
Mudanças na loja começam como propostas. As mudanças de SEO de produtos, categorias e imagens são criadas primeiro como propostas, e só as que você aprovar chegam à loja.
Seu papel vale. O assistente trabalha com o seu papel em cada espaço de trabalho. Com o papel Leitor, ele só pode ler informações básicas do espaço de trabalho.
Os mesmos limites de uso. As ações de um assistente contam para os mesmos limites de uso que o seu trabalho no app.

Solução de problemas

O link de conexão expirou: a página de aprovação vale por 10 minutos. Comece a conexão de novo pelo assistente.
O assistente diz que perdeu o acesso: conecte-o de novo. Em Configurações → Assistentes de IA (MCP) você vê se o app foi desconectado.
O limite de uso acabou: espere até ele ser renovado e peça de novo.
Uma ferramenta diz que uma integração não está conectada: conecte o Google Search Console, o WordPress ou a sua loja em Configurações → Integrações e peça de novo. Veja Conecte o seu site ou a sua loja.

Próximos passos

IntegraçõesConecte o Search Console, o WordPress e a sua loja.
BibliotecaRevise os rascunhos que o seu assistente criou.
Calendário de conteúdoArtigos e posts agendados em um só lugar.
Agentes de IAConheça os agentes do Semurai e o trabalho que eles assumem.
Servidor MCP do SemuraiO que cada assistente pode fazer com o Semurai, com prompts de exemplo.