Tidio MCP Server

공식

MCP를 통해 Tidio를 웹사이트에 연결하세요. 프로그래밍 환경을 벗어나지 않고 위젯을 임베드할 수 있습니다.

tid.io에서 보기

문서

Tidio MCP 커넥터

AI 어시스턴트를 Tidio 라이브 채팅에 연결하는 MCP(Model Context Protocol) 서버 - 자동 설정 지원

기능

자동 설정: 하나의 명령어로 Tidio에 연결 - 수동 키 복사 불필요
OAuth 인증: 안전한 Tidio 로그인을 위해 브라우저를 열고 공개 키를 자동으로 가져옴
자격 증명 유지: 이후 세션을 위해 자격 증명을 로컬에 저장
임베드 코드 생성: 모든 웹사이트에 바로 사용할 수 있는 JavaScript 코드 제공

설치

npm install tidio-mcp-connector

또는 로컬에 클론하여 빌드:

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

사용법

Claude Desktop과 함께 사용

Claude Desktop 설정(~/Library/Application Support/Claude/claude_desktop_config.json)에 추가:

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

Lovable과 함께 사용

이 MCP 커넥터는 Lovable 및 유사한 AI 기반 개발 플랫폼에서 작동합니다. 사용자 정의 MCP 서버로 추가하세요.

MCP Inspector와 함께 사용 (테스트)

npx @modelcontextprotocol/inspector npx tidio-mcp-connector

사용 가능한 도구

`tidio_connect` (권장)

Tidio에 연결하고 공개 키를 자동으로 가져옵니다.

작동 방식:

브라우저에서 Tidio 로그인 페이지를 엽니다
Tidio 계정으로 인증합니다
공개 키와 임베드 코드를 자동으로 반환합니다

매개변수:

site_url (필수): Tidio가 임베드될 웹사이트 URL

예시:

Connect Tidio to https://mywebsite.com

`tidio_status`

연결 상태를 확인하고 임베드 코드를 가져옵니다.

매개변수: 없음

`tidio_disconnect`

저장된 자격 증명을 삭제합니다.

`generate_tidio_embed`

특정 공개 키에 대한 임베드 코드를 생성합니다 (이미 키가 있는 경우).

매개변수:

public_key (필수): Tidio 공개 키
loading_mode (선택 사항): "async" (기본값) 또는 "sync"

작동 방식

사용자가 tidio_connect 호출 (웹사이트 URL 포함)
브라우저 열림 - Tidio 인증 페이지로 이동
사용자 로그인 - Tidio 계정에 로그인
콜백 수신 - MCP 서버가 갱신 토큰을 받음
API 호출 수행 - 토큰을 액세스 토큰으로 교환한 후 공개 키를 가져옴
자격 증명 저장 - ~/.tidio-mcp/credentials.json에 저장
임베드 코드 반환 - 웹사이트에 추가할 준비 완료

자격 증명 저장소

자격 증명은 ~/.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" }

임베드 코드 출력

커넥터는 최적화된 비동기 로딩 코드를 생성합니다:

개발

의존성 설치

npm install

개발 모드로 실행

npm run dev

프로덕션용 빌드

npm run build

빌드된 버전 실행

npm start

요구 사항

Node.js 18 이상
Tidio 계정 (무료 등급 사용 가능)

라이선스

MIT