Pré-requisitos \
- Uma conta do OneSignal com acesso aos aplicativos do OneSignal que você deseja gerenciar.
- Permissão para aprovar o acesso ao OneSignal por meio do OAuth, o login baseado em navegador que o OneSignal usa.
- Uma ferramenta de IA compatível com servidores MCP remotos via HTTP com OAuth.
Detalhes da conexão \
Todas as ferramentas de IA se conectam ao mesmo endpoint hospedado:Configure sua ferramenta de IA \
Cursor \
Instale o OneSignal pelo Cursor Marketplace.Abra o plugin do OneSignal
Instale o plugin
Faça login no OneSignal
Use o OneSignal no chat do Agent
mcp.json:
Claude Code \
Adicione o servidor MCP do OneSignal
Autentique-se dentro do Claude Code
claude e digite /mcp para abrir o painel MCP. Selecione onesignal e escolha Authenticate para abrir a página de login do OneSignal no navegador.Aprove o acesso
claude mcp list, ou /mcp dentro do Claude Code, para ver a quantidade de ferramentas.
Conector personalizado do Claude \
Use um conector personalizado apenas quando não for possível instalar o OneSignal pelo diretório do Claude. Servidores MCP remotos não podem ser adicionados peloclaude_desktop_config.json, que serve apenas para servidores stdio locais.
Adicione um conector personalizado
Informe os detalhes do servidor
OneSignal e Remote MCP server URL como https://api.onesignal.com/mcp/oauth. Deixe OAuth Client ID e OAuth Client Secret, em Advanced settings, em branco.Faça login no OneSignal
Codex CLI \
Abra o navegador de plugins
codex e digite /plugins.Instale o OneSignal
Inicie uma nova sessão e faça login
GitHub Copilot no VS Code \
Adicione o OneSignal ao.vscode/mcp.json do seu workspace para compartilhá-la com sua equipe, ou execute MCP: Open User Configuration na Paleta de Comandos para instalá-la no seu perfil de usuário:
Outras ferramentas e agentes de IA \
Adicionehttps://api.onesignal.com/mcp/oauth nas configurações de servidor MCP remoto da sua ferramenta de IA. Na primeira vez que a ferramenta de IA chamar uma ferramenta do OneSignal, ela abrirá a página de login do OneSignal no navegador. Faça login e clique em Agree & Allow Access. Sua ferramenta de IA lista as ferramentas do OneSignal assim que a conexão for bem-sucedida.
Verifique a conexão \
Inicie um novo chat ou sessão e envie:onesignal_health. Ela responde antes de o acesso por ferramentas de IA ser ativado, então um resultado saudável não confirma que as outras ferramentas funcionam.
Solução de problemas \
- Autentique-se novamente. Reconecte o OneSignal nas configurações de MCP ou de conectores da sua ferramenta de IA e inicie uma nova sessão.
-
Verifique a URL do servidor. A URL deve ser exatamente
https://api.onesignal.com/mcp/oauth, sem caminho extra nem caracteres no final. - Limpe os campos do cliente OAuth. Se sua ferramenta de IA tiver campos de ID ou segredo do cliente OAuth, deixe-os em branco.
- Verifique o acesso por ferramentas de IA. Se uma ferramenta retornar “tool access is not enabled for this application”: O OneSignal ainda não ativou o acesso por ferramentas de IA para o seu login do OneSignal. Entre em contato com o suporte do OneSignal.
- Reinicie sua ferramenta de IA e inicie uma nova sessão. Isso resolve a maioria dos problemas temporários de conexão.
Ferramentas \
Explore as ferramentas abaixo. A descoberta de ferramentas depende da ativação do MCP no seu aplicativo ou conta do OneSignal. Cada operação também verifica as permissões do seu aplicativo do OneSignal.Aplicativos (2 ferramentas) \
Journeys (9 ferramentas) \
Gerenciar Journeys com MCP
Mensagens (3 ferramentas) \
Usuários e assinaturas (12 ferramentas) \
Templates (4 ferramentas) \
Segmentos (4 ferramentas) \
Live Activities (2 ferramentas) \
Exportações (2 ferramentas) \
Eventos personalizados (2 ferramentas) \
Entregabilidade de e-mail (4 ferramentas) \
Aquecimento de e-mail (5 ferramentas) \
Análises e utilitários (4 ferramentas) \
Segurança e proteções \
- O OneSignal marca
send_messagecomo uma ferramenta de alto impacto, então ferramentas de IA que respeitam anotações de ferramentas podem pedir confirmação antes de executá-la. send_messagevalida a segmentação antes do envio: apenas um método de segmentação por solicitação, e os filtros têm um limite.- O OneSignal valida as entradas antes da execução, incluindo identificadores, endereços de e-mail e números de telefone.
- Para requisitos de concorrência de Journeys, controles de ciclo de vida e recuperação após gravações incertas, veja o guia de solicitações de Journeys.
- O OneSignal ativa ou desativa o acesso por ferramentas de IA para cada login do OneSignal.
- O servidor MCP não armazena os dados dos seus clientes (assinantes, mensagens, exportações).
Limites e uso \
Conectar o OneSignal é gratuito. Cada ação conta para os limites normais de uso da API do OneSignal. O plano do seu provedor de IA pode ter custos próprios.- As chamadas de ferramentas têm limite de taxa para evitar loops descontrolados.
- Uma conexão segue as permissões do usuário conectado e pode acessar todos os aplicativos do OneSignal que esse usuário pode gerenciar.
- Pode ser necessário que o OneSignal ative o acesso por ferramentas de IA para o seu login antes que ferramentas além das utilitárias funcionem.
FAQ \
Preciso de uma chave da REST API? \
Não. Todas as conexões usam o OAuth do OneSignal. Você faz login pelo navegador e aprova o acesso, então não há chave de API para copiar, armazenar ou rotacionar.Como trabalho com mais de um aplicativo do OneSignal? \
Uma única conexão abrange todos os aplicativos que sua conta do OneSignal pode gerenciar. Chamelist_apps para encontrar os IDs dos aplicativos. Você não precisa de uma configuração separada para cada aplicativo.
Posso conectar uma ferramenta de IA que só é compatível com servidores stdio locais? \
Não. O servidor MCP do OneSignal é um servidor remoto via HTTP. Sua ferramenta de IA precisa ser compatível com servidores MCP remotos com OAuth.Como revogo o acesso de uma ferramenta de IA? \
Acesse Settings > Account settings > Connected apps no OneSignal e revogue a conexão. Revogar a conexão não afeta as conexões dos seus colegas de equipe.Páginas relacionadas \
Usar o OneSignal no Claude e no ChatGPT
Gerenciar Journeys com MCP
Visão geral da REST API
API de criação de mensagens
send_message.