crisp-mcp-server

Model Context Protocol 서버로, Crisp REST API용이며 Cloudflare Workers에 배포됩니다.

Crisp 웹사이트, 운영자, 대화를 MCP 도구로 노출하여, MCP 호환 AI 에이전트가 이를 조회하고 비공개 메모를 게시하며 대화 세그먼트를 관리할 수 있게 합니다.

도구

Related MCP server: neon-mcp

인증

서버는 상태 비저장이며 자격 증명이 없습니다: 어떤 Crisp 토큰도 저장하지 않습니다. 각 MCP 클라이언트는 Crisp 토큰을 엔드포인트에 직접 전달합니다.

Crisp REST API는 token_id:token_key 키페어를 사용하는 Basic 인증을 사용합니다. token_id:token_key 문자열을 Base64로 인코딩하고 이를 Bearer 토큰으로 MCP 엔드포인트에 전달하세요:

Authorization: Bearer <base64(token_id:token_key)>

Worker는 해당 값을 Authorization: Basic <base64(...)>로 Crisp API에 전달합니다.

티어

Crisp 토큰은 website(단일 워크스페이스) 또는 plugin(다중 워크스페이스) 중 하나입니다. tier 쿼리 매개변수로 티어를 선택하세요:

• ?tier=website (기본값) — X-Crisp-Tier: website로 설정합니다.

• ?tier=plugin — X-Crisp-Tier: plugin으로 설정합니다.

토큰은 Crisp 앱에서 생성하세요: 설정 → 워크스페이스 설정 → 고급 구성 → API 토큰(website), 또는 Crisp Marketplace(plugin)에서 생성하세요.

개발

npm install
npm run dev      # local dev at http://localhost:8787
npm run typecheck

배포

npm run deploy

그런 다음 MCP 클라이언트를 https://<your-worker>.workers.dev/mcp?tier=website로 지정하고 Authorization: Bearer <base64(...)> 헤더를 함께 사용하세요.

Claude Desktop / Claude Code 예시

{
  "mcpServers": {
    "crisp": {
      "url": "https://<your-worker>.workers.dev/mcp?tier=website",
      "headers": {
        "Authorization": "Bearer <base64(token_id:token_key)>"
      }
    }
  }
}

작동 방식

• src/index.ts — Worker 진입점입니다. 요청에서 Bearer 토큰과 티어를 추출하고, 요청마다 새 MCP 서버를 만든 다음 createMcpHandler(상태 비저장 Streamable HTTP 전송)에 전달합니다.

• src/crisp.ts — 가벼운 읽기 전용 Crisp REST 클라이언트입니다(https://api.crisp.chat/v1).

• src/tools.ts — 위의 MCP 도구를 등록합니다.

참고 사항

• 읽기 전용 위주: 비공개 메모와 대화 세그먼트만 수 있으며, 다른 모든 도구는 읽기 전용입니다.

• 상태 비저장: Durable Objects, 세션, 저된 자격 증명이 없습니다.

• Crisp 토큰은 모든 연결에서 클라이언트가 보냅니다. 유출된 경우 Crisp 앱에서 교체하세요.