Tidio MCP Server

oficial

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

Ver em tid.io

Documentação

Conector Tidio MCP

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

Funcionalidades

  • Configuração Automática: Conecte-se ao Tidio com um comando - sem cópia manual de chaves
  • 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 compile 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 à 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 o Lovable e plataformas de desenvolvimento similares baseadas em IA. Adicione-o como um servidor MCP personalizado.

Com MCP Inspector (Testes)

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ê se 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

Limpar credenciais armazenadas.

generate_tidio_embed

Gerar 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. Usuário chama tidio_connect com a URL do seu site
  2. Navegador abre na página de autenticação do Tidio
  3. Usuário faz login na sua conta Tidio
  4. Callback recebido - servidor MCP obtém o token de atualização
  5. Chamadas de API feitas - troca o token por um token de acesso, 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:

Desenvolvimento

Instalar dependências

npm install

Executar em modo de desenvolvimento

npm run dev

Compilar para produção

npm run build

Executar versão compilada

npm start

Requisitos

  • Node.js 18+
  • Uma conta Tidio (plano gratuito funciona)

Licença

MIT

Relacionados

  • Tidio - Plataforma de chat ao vivo e chatbot
  • Model Context Protocol - Padrão aberto para integrações de IA
  • Lovable - Desenvolvimento de aplicativos com IA