Como utilizar e configurar o MCP Stilingue

1. Resumo
2. Ferramentas disponíveis por grupo
3. Matriz de compatibilidade
4. Passo a passo de conexão
5. FAQ e Resolução de problemas (Troubleshooting)
6. Governança e segurança
7. Informações úteis para abertura de chamado
8. Referências das LLMs

Resumo

O MCP (Model Context Protocol) é um padrão aberto que permite a aplicações de IA acessar ferramentas e fontes externas de forma padronizada. O Stilingue conectado na sessão é um servidor MCP que expõe consultas e operações de social listening.

Aviso de Arquitetura: A integração não “instala um modelo” dentro do Stilingue. A LLM usa um modelo compatível com ferramentas e chama as ferramentas disponibilizadas pelo servidor.

As ferramentas disponíveis incluem Radar, Radar Dashboard, Warroom, setup, SmartCare e operações de edição de temas e grupos. Algumas exigem permissões específicas; operações de edição devem ser tratadas como mudança de configuração.

Antes de começar

Para realizar as configurações e conexões apresentadas neste artigo, certifique-se de que possui os seguintes requisitos descritos na documentação enviada:

• Servidor MCP Stilingue habilitado e acessível.

• Permissões de acesso necessárias (leitura, consulta de setup ou edição de descritores).

• Account ID e Universe/Painel configurados.

• Credenciais de login da Stilingue ativas para autenticação.

• Acesso às configurações de conectores/plugins/developer mode do host ou workspace desejado.

• URL oficial do conector remoto: [https://mcp.stilingue.com.br](https://mcp.stilingue.com.br).

Ferramentas disponíveis por grupo

Matriz de compatibilidade

Passo a passo de conexão

Conectando via Claude (Remote MCP)

1. Abra o menu Customize.

2. Clique na opção Connectors.

3. Escolha a opção + Add.

4. Selecione Add custom connector.

5. Informe um nome para a conexão (por exemplo, “Stilingue”).

6. Cole a URL remota oficial do MCP Stilingue ([https://mcp.stilingue.com.br](https://mcp.stilingue.com.br)).

   • Atenção: Não use uma URL inventada nem o endereço interno do Manus.

7. Revise os parâmetros de OAuth, headers e escopos.

8. Conclua clicando em Add.

9. Na interface de conversa, clique no botão +.

10. Acesse Connectors para ativar o conector e execute um teste de leitura.

    • Nota técnica: Se o servidor estiver em uma rede privada, a infraestrutura do host remoto precisa alcançar o endpoint; VPN local ou firewall podem impedir a conexão.

Conectando via ChatGPT / OpenAI

1. Confirme com o administrador da conta se o Developer mode, Apps/Plugins ou custom connectors estão habilitados no seu workspace.

2. Adicione o servidor MCP remoto através da superfície disponibilizada pela sua organização.

3. Informe a URL oficial do servidor.

4. Conclua o fluxo de autenticação OAuth ou o mecanismo exigido pela plataforma.

   • Para API/Responses, utilize a estrutura documentada com a ferramenta do tipo mcp, definindo o server_url e, opcionalmente, o parâmetro allowed_tools:

"tools": [{"type":"mcp", "server_label":"stilingue", 
"server_url":"https://mcp.stilingue.com.br/mcp",
"require_approval":"always"}]

5. Mantenha o recurso de aprovação habilitado para ferramentas que alteram dados; para consultas de leitura, a política pode permitir aprovação automática conforme o nível de risco.

Conectando via VS Code / GitHub Copilot Chat

1. Abra a Command Palette.

2. Selecione a opção MCP: Add Server ou crie um arquivo .mcp.json portátil na raiz do projeto.

3. Insira a configuração JSON substituindo pelo endpoint oficial e adicionando a autenticação conforme a documentação do Stilingue:

{
  "mcpServers": {
    "stilingue": {
      "type": "http",
      "url": "https://mcp.stilingue.com.br/mcp"
    }
  }
}

Conectando via Cursor

1. Acesse o menu Customize ou crie o arquivo no caminho .cursor/mcp.json no repositório.

2. Adicione o bloco de código de configuração do servidor:

{
  "mcpServers": {
    "stilingue": {
      "url": "https://mcp.stilingue.com.br/mcp"
    }
  }
}

3. O Cursor suporta os transportes stdio, SSE e Streamable HTTP. Para autenticação OAuth, utilize o fluxo nativo do próprio cliente; para tokens fixos, utilize variáveis de ambiente e nunca insira credenciais diretamente (hardcode) no repositório.

Conectando via Gemini CLI

1. Abra o terminal e execute o comando de adição: gemini mcp add --transport http stilingue https://mcp.stilingue.com.br/mcp

2. Valide a instalação executando o comando: gemini mcp list

3. Se o servidor exigir envio de cabeçalho, adicione o parâmetro --header seguindo a política de gerenciamento de segredos da sua equipe.

Treinamento e validação

Fluxo visual de treinamento

O GIF ilustrativo a seguir resume a estrutura mental para a conexão em qualquer host MCP: escolha o cliente, informe o endpoint oficial, realize a autenticação e ative somente as ferramentas necessárias.

Teste de validação pós-conexão

Sempre execute uma consulta de leitura antes de realizar qualquer alteração no ambiente:

1. Solicite à LLM: “Liste as ferramentas Stilingue disponíveis e explique quais exigem API key.”

2. Solicite à LLM: “Use o Radar para consultar uma busca simples e retorne o tipo de dado consultado.”

3. Para testes no Warroom, solicite: “Liste os painéis aos quais tenho acesso” (executar este passo somente se o host ou sessão possuir a ferramenta list_panels e a identidade necessária habilitada).

4. Registre o resultado obtido, o horário da validação, o host utilizado, a versão e a mensagem de erro recebida (se houver).

   • Segurança: Não registre tokens de acesso nos relatórios.

FAQ e Resolução de problemas (Troubleshooting)

Perguntas Frequentes (FAQ)

O MCP estava funcionando normalmente, mas depois de algumas semanas não conseguiu acessar mais as ferramentas. O que aconteceu?

A conexão do MCP é feita via login da plataforma STILINGUE. Da mesma forma que a plataforma exige refazer a autenticação após um determinado tempo, o MCP precisa dessa atualização por estar ligado diretamente com o servidor da Stilingue. Para resolver, reconecte o MCP para que a janela de login da Stilingue seja exibida novamente.

O MCP é um modelo de Inteligência Artificial?

Não. Trata-se de um protocolo de integração. O modelo de IA roda dentro de uma LLM (Claude, ChatGPT, Copilot, etc.), e essa LLM utiliza o protocolo MCP para chamar ferramentas externas.

O Stilingue funciona com qualquer modelo do GPT, Claude ou Gemini?

Não automaticamente. O modelo precisa estar hospedado em uma LLM que suporte a execução de ferramentas/MCP, e a aplicação precisa aceitar a camada de transporte e a autenticação exigida pelo servidor.

Onde encontro a URL oficial do conector?

O endereço oficial é [https://mcp.stilingue.com.br](https://mcp.stilingue.com.br).

Por que a interface exibe a mensagem “tool not found”?

O servidor pode estar conectado, mas a ferramenta específica pode não ter sido habilitada na LLM, ou pode existir a necessidade de vincular a conta novamente com um novo login.

Por que a consulta do Radar funciona e a do Warroom falha?

O Radar realiza consultas em bases públicas sem exigência de API key. O Warroom é um ambiente proprietário e depende da validação de account, painel, API key e permissões específicas de acesso.

Qual é a função da ferramenta setup?

A ferramenta consulta a estrutura de configuração de um painel, exibindo os grupos e temas configurados.

O que fazer se a janela de autenticação OAuth não abrir?

Verifique o bloqueador de pop-ups do navegador, o domínio acessado, o relógio do sistema, a URI de redirecionamento (redirect URI) e as políticas do seu workspace. Tente realizar o procedimento novamente em uma janela anônima e confirme se o endpoint é público.

Como diferenciar um problema da LLM de uma falha do Stilingue?

Após uma falha no MCP, teste o acesso diretamente na plataforma Stilingue. Se a plataforma apresentar lentidão ou erros de sistema, trata-se de um problema geral no servidor Stilingue.

Tabela de Troubleshooting Rápido

• Sintoma: O servidor não aparece na interface.

  • Causa provável: A LLM não suporta o protocolo MCP ou a configuração não foi recarregada.

  • Ação: Atualize o aplicativo cliente, verifique o arquivo ou menu de configurações do MCP e confirme o tipo de transporte.

• Sintoma: Ocorre falha na tentativa de conexão.

  • Causa provável: Uso de URL privada, endpoint incorreto ou bloqueio por firewall.

  • Ação: Teste a acessibilidade HTTPS do endereço e confirme a URL oficial. Não substitua por URLs de ambientes internos.

• Sintoma: Erro de autenticação 401 ou 403.

  • Causa provável: Autenticação OAuth ou token ausente, expirado ou com escopo de permissão insuficiente.

  • Ação: Refaça a autenticação e revise as permissões da conta com o administrador.

• Sintoma: As ferramentas aparecem listadas, mas a execução falha.

  • Causa provável: Ausência de parâmetros obrigatórios, ID do painel ou API key.

  • Ação: Consulte a estrutura (schema) da ferramenta, confirme os IDs informados e as permissões de acesso.

• Sintoma: A busca retorna um resultado vazio.

  • Causa provável: Consulta/filtros estruturados incorretamente ou ausência de dados no período pesquisado.

  • Ação: Simplifique a consulta enviada, teste um intervalo de datas maior e valide a taxonomia da busca.

• Sintoma: Ocorre uma alteração inesperada na configuração.

  • Causa provável: Ferramenta de edição habilitada sem a necessidade de aprovação.

  • Ação: Desabilite as permissões de edição, revise os logs de alteração e exija confirmação operacional antes da execução.

Governança e segurança

• Aplique o princípio do menor privilégio: mantenha permissões de leitura por padrão e conceda permissões de edição somente para operadores autorizados.

• Confirme se a URL do servidor MCP corresponde exatamente ao endpoint oficial antes de realizar qualquer autenticação.

• Revise atentamente a ferramenta selecionada e os parâmetros informados antes de executar operações que alterem grupos ou temas.

• Para manipulação de dados proprietários, siga rigorosamente as diretrizes da LGPD, a política de retenção de informações e a classificação de dados da organização.

Informações úteis para abertura de chamado

Ao abrir um chamado de suporte referente ao MCP Stilingue, certifique-se de reunir e fornecer as seguintes informações:

1. Nome da LLM utilizada (Claude, ChatGPT, VS Code, Cursor, Copilot, etc.).

2. Identificação se a conexão é gerenciada pela organização ou de uso individual.

3. Account ID e Universe/Painel com as ferramentas apresentando problema.

4. Nível de permissão esperada: leitura, consulta de setup ou edição de descritores.

Referências das LLMs

Para mais detalhes técnicos e atualizações dos protocolos nos clientes suportados, consulte a documentação oficial das LLMs:

• Model Context Protocol Documentation

• Claude Support — Get started with custom connectors using Remote MCP

• Claude Support — Getting started with local MCP servers on Claude Desktop

• OpenAI Developers — MCP API Reference

• VS Code Documentation — Copilot Chat MCP Servers

• Cursor Documentation — Context MCP

• Gemini CLI — MCP Server Tool Documentation

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃