Tidio

oficial

Conecte o Tidio ao seu site via MCP. Incorpore o widget sem sair do seu ambiente de programação.

O que você pode fazer com Tidio MCP?

  • Conectar Tidio a um site — Peça para conectar Tidio a uma URL de site via tidio_connect, que abre um navegador para login OAuth e recupera automaticamente sua chave pública.
  • Verificar status da conexão — Use para verificar se o Tidio está conectado e recuperar seu código de incorporação atual.
  • Gerar código de incorporação — Chame com uma chave pública para produzir JavaScript pronto para uso, opcionalmente escolhendo carregamento async ou sync.
  • Desconectar Tidio — Execute para limpar credenciais armazenadas localmente em ~/.tidio-mcp/credentials.json.

Documentação

Conector MCP Tidio

Um servidor MCP (Model Context Protocol) que conecta assistentes de IA ao Tidio chat ao vivo - com configuração automática

Recursos

  • Configuração Automática: Conecte-se ao Tidio com um comando - sem copiar chaves manualmente
  • Autenticação OAuth: Abre o navegador para login seguro no Tidio, recupera automaticamente sua chave pública
  • Persistência de Credenciais: As credenciais são salvas localmente para sessões futuras
  • Geração de Código de Incorporação: Obtenha código JavaScript pronto para uso em qualquer site

Instalação

npm install tidio-mcp-connector

Ou clone e construa localmente:

git clone https://github.com/your-username/tidio-mcp-connector.git
cd tidio-mcp-connector
npm install
npm run build

Uso

Com Claude Desktop

Adicione à sua configuração do Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tidio": {
      "command": "npx",
      "args": ["tidio-mcp-connector"]
    }
  }
}

Com Lovable

Este conector MCP funciona com Lovable e plataformas de desenvolvimento similares com IA. Adicione-o como um servidor MCP personalizado.

Com MCP Inspector (Teste)

npx @modelcontextprotocol/inspector npx tidio-mcp-connector

Ferramentas Disponíveis

tidio_connect (Recomendado)

Conecte-se ao Tidio e obtenha automaticamente sua chave pública.

Como funciona:

  1. Abre seu navegador na página de login do Tidio
  2. Você autentica com sua conta Tidio
  3. Retorna sua chave pública e código de incorporação automaticamente

Parâmetros:

  • site_url (obrigatório): A URL do site onde o Tidio será incorporado

Exemplo:

Connect Tidio to https://mywebsite.com

tidio_status

Verifique o status da sua conexão e obtenha seu código de incorporação.

Parâmetros: Nenhum

tidio_disconnect

Limpe as credenciais armazenadas.

Parâmetros: Nenhum

generate_tidio_embed

Gere código de incorporação para uma chave pública específica (se você já tiver uma).

Parâmetros:

  • public_key (obrigatório): Sua chave pública do Tidio
  • loading_mode (opcional): "async" (padrão) ou "sync"

Como Funciona

  1. O usuário chama tidio_connect com a URL do seu site
  2. O navegador abre a página de autenticação do Tidio
  3. O usuário faz login na sua conta Tidio
  4. Callback recebido - o servidor MCP obtém o refresh token
  5. Chamadas de API feitas - troca o token por um token de acesso e depois recupera a chave pública
  6. Credenciais salvas em ~/.tidio-mcp/credentials.json
  7. Código de incorporação retornado - pronto para adicionar ao site

Armazenamento de Credenciais

As credenciais são armazenadas localmente em ~/.tidio-mcp/credentials.json:

{
  "public_key": "abc123...",
  "access_token": "...",
  "refresh_token": "...",
  "site_url": "https://example.com",
  "created_at": "2024-01-01T00:00:00.000Z",
  "updated_at": "2024-01-01T00:00:00.000Z"
}

Saída do Código de Incorporação

O conector gera código de carregamento assíncrono otimizado:

<script type="text/javascript">
document.tidioChatCode = "YOUR_PUBLIC_KEY";
(function() {
  function asyncLoad() {
    var tidioScript = document.createElement("script");
    tidioScript.type = "text/javascript";
    tidioScript.async = true;
    tidioScript.src = "//code.tidio.co/YOUR_PUBLIC_KEY.js";
    document.body.appendChild(tidioScript);
  }
  if (window.attachEvent) {
    window.attachEvent("onload", asyncLoad);
  } else {
    window.addEventListener("load", asyncLoad, false);
  }
})();
</script>

Desenvolvimento

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run built version
npm start