Como usar o MCP (Model Context Protocol) na systeme.io

O novo recurso MCP oferece a usuários, parceiros e desenvolvedores uma maneira poderosa de interagir com a systeme.io utilizando ferramentas de IA.

Observações:
O servidor MCP foca atualmente na gestão de contatos (contatos, tags e campos personalizados), gestão de newsletters e funis.

1. O que é MCP?

MCP (Model Context Protocol) é um padrão que permite que assistentes de IA (como ChatGPT ou Claude) se conectem com segurança a plataformas externas.

Com o MCP, você pode usar comandos de linguagem natural para interagir com seus dados na systeme.io. Por exemplo, você pode pedir ao ChatGPT para encontrar um contato ou adicionar uma tag apenas digitando uma frase.

Atualmente, nosso recurso MCP oferece acesso direto a recursos específicos de gestão de contatos, permitindo que você use a IA para gerenciar seus contatos, tags e campos de contato.

2. Como funciona o recurso MCP?

O servidor MCP da systeme.io permite que aplicativos de IA acessem ferramentas específicas de gestão de contatos em sua conta. Ele cria uma ponte entre:

O host: sua ferramenta de IA (ex.: ChatGPT, Claude).
O servidor: sua conta na systeme.io.

Uma vez conectada, a IA pode executar comandos para gerenciar seus contatos e tags automaticamente.

Para detalhes técnicos, consulte nossa documentação oficial do servidor MCP (em inglês): https://developer.systeme.io/docs/mcp-server.

3. Como gerar suas chaves MCP

Para conectar uma ferramenta de IA, primeiro você precisa gerar uma chave MCP segura.

Acesse o menu em sua foto de perfil e selecione Configurações (1).

No menu à esquerda, clique em Chaves MCP e de API (2).

Role a página até a seção Chaves MCP e clique em Criar (3).

Atribua um nome à sua chave, defina uma data de expiração e clique em Salvar (4).

Sua chave está pronta.

4. Conecte sua ferramenta de IA

Depois de gerar suas chaves MCP, siga os tutoriais específicos para conectar sua ferramenta de IA preferida com a systeme.io:

5. O que você pode fazer com o nosso servidor MCP?

Você pode usar ferramentas de IA para realizar as seguintes ações:

a. Gestão de contatos:

Criar e atualizar contatos: adicionar novos contatos ou atualizar informações de contatos existentes.
Excluir contatos: remover contatos da sua lista.
Listar e buscar contatos: usar filtros para listar contatos ou obter detalhes específicos de um contato.
Gerenciar tags: criar, atribuir, listar e remover tags de contatos.
Obter campos de contato (campos personalizados): listar campos de contato disponíveis e seus identificadores (slugs) para que a IA possa preencher e atualizar as informações corretamente.

b. Gestão de newsletters:

Criar e atualizar newsletters: crie novos rascunhos de newsletters em segundos, ou atualize rascunhos existentes (assunto, texto de pré-visualização e conteúdo do email).
Listar e buscar newsletters: navegue por suas newsletters ou pesquise emails específicos.

Observação sobre newsletters: as newsletters criadas via MCP utilizam automaticamente o nome e o email de remetente padrão configurados em sua conta (no momento estes dados não podem ser atualizados via MCP). Também não é possível excluir newsletters usando ferramentas de MCP.

c. Gestão de funis:

Criar funis e etapas de inscrição: use sua ferramenta de IA para gerar facilmente novos funis e etapas específicas de funis do tipo inscrição.
Listar e buscar funis: navegue por seus funis e etapas de inscrição existentes ou pesquise por itens específicos.

Observação sobre funis: atualmente, esse recurso suporta apenas a criação e pesquisa de etapas de funil do tipo inscrição. Modificar (editar) ou excluir funis e etapas de funis via MCP não é possível no momento.

Por razões de segurança, as chaves MCP são válidas por um período máximo de 90 dias.
Você pode criar no máximo duas chaves MCP simultaneamente.
Esta é uma implementação inicial e ainda não suporta o método de autenticação recomendado (OAuth). Por isso, instabilidades pontuais poderão acontecer.
A compatibilidade com OAuth está planejada. Uma vez lançado, ele aumentará a segurança e eliminará a necessidade de expiração das chaves.