Intercom용 MCP 서버

AI 도우미가 Intercom의 고객 지원 데이터에 액세스하여 분석할 수 있도록 하는 MCP 호환 서버입니다.

특징

• 고급 필터링으로 대화 및 티켓 검색

• 고객, 상태, 날짜 범위 및 키워드로 필터링

• 연락처가 없어도 이메일 내용으로 검색

• Intercom의 검색 API를 통한 효율적인 서버 측 필터링

• MCP 호환 AI 어시스턴트와의 원활한 통합

Related MCP server: jitbit-helpdesk-mcp

설치

필수 조건

• Node.js 18.0.0 이상

• API 액세스가 가능한 Intercom 계정

• Intercom API 토큰(Intercom 계정 설정에서 사용 가능)

빠른 설정

NPM 사용하기

지엑스피1

Docker 사용

기본 Docker 구성은 Glama 호환성을 위해 최적화되었습니다.

# Start Docker (if not already running)
# On Windows: Start Docker Desktop application
# On Linux: sudo systemctl start docker

# Build the image
docker build -t mcp-intercom .

# Run the container with your API token and port mappings
docker run --rm -it -p 3000:3000 -p 8080:8080 -e INTERCOM_ACCESS_TOKEN="your_token_here" mcp-intercom:latest

검증 단계:

# Test the server status
curl -v http://localhost:8080/.well-known/glama.json
# Test the MCP endpoint
curl -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"mcp.capabilities"}' http://localhost:3000

대체 표준 버전

Glama 특정 종속성이 없는 더 가벼운 버전을 선호하는 경우:

# Build the standard image
docker build -t mcp-intercom-standard -f Dockerfile.standard .

# Run the standard container
docker run --rm -it -p 3000:3000 -p 8080:8080 -e INTERCOM_ACCESS_TOKEN="your_token_here" mcp-intercom-standard:latest

기본 버전에는 Glama 플랫폼과 통합하는 데 필요한 특정 종속성과 구성이 포함되어 있는 반면, 표준 버전은 더 가볍습니다.

사용 가능한 MCP 도구

1. list_conversations

콘텐츠 필터링을 통해 특정 날짜 범위 내의 모든 대화를 검색합니다.

매개변수:

• startDate (DD/MM/YYYY) – 시작일(필수)

• endDate (DD/MM/YYYY) – 종료 날짜(필수)

• keyword (문자열) – 이 텍스트가 포함된 대화를 포함하도록 필터링합니다.

• exclude (문자열) – 이 텍스트가 포함된 대화를 제외하기 위한 필터

참고사항:

• 날짜 범위는 7일을 초과할 수 없습니다.

• Intercom의 검색 API를 통해 효율적인 서버 측 필터링을 사용합니다.

예:

{
  "startDate": "15/01/2025",
  "endDate": "21/01/2025",
  "keyword": "billing"
}

2. search_conversations_by_customer

특정 고객에 대한 대화를 찾습니다.

매개변수:

• customerIdentifier (문자열) – 고객 이메일 또는 Intercom ID(필수)

• startDate (DD/MM/YYYY) – 선택 시작일

• endDate (DD/MM/YYYY) – 선택적인 종료 날짜

• keywords (배열) – 콘텐츠로 필터링할 선택적 키워드

참고사항:

• 연락처가 없더라도 이메일 내용으로 대화를 찾을 수 있습니다.

• 효율적인 검색을 위해 이메일을 연락처 ID로 변환합니다.

예:

{
  "customerIdentifier": "customer@example.com",
  "startDate": "15/01/2025",
  "endDate": "21/01/2025",
  "keywords": ["billing", "refund"]
}

3. search_tickets_by_status

티켓을 상태별로 검색합니다.

매개변수:

• status (문자열) – "열림", "보류 중" 또는 "해결됨"(필수)

• startDate (DD/MM/YYYY) – 선택 시작일

• endDate (DD/MM/YYYY) – 선택적인 종료 날짜

예:

{
  "status": "open",
  "startDate": "15/01/2025",
  "endDate": "21/01/2025"
}

4. search_tickets_by_customer

특정 고객과 관련된 티켓을 찾습니다.

매개변수:

• customerIdentifier (문자열) – 고객 이메일 또는 Intercom ID(필수)

• startDate (DD/MM/YYYY) – 선택 시작일

• endDate (DD/MM/YYYY) – 선택적인 종료 날짜

예:

{
  "customerIdentifier": "customer@example.com",
  "startDate": "15/01/2025",
  "endDate": "21/01/2025"
}

Claude Desktop을 사용한 구성

claude_desktop_config.json 에 다음을 추가하세요:

{
  "mcpServers": {
    "intercom-mcp": {
      "command": "intercom-mcp",
      "args": [],
      "env": {
        "INTERCOM_ACCESS_TOKEN": "your_intercom_api_token"
      }
    }
  }
}

구현 노트

이 서버가 Intercom API와 통합되는 방식에 대한 자세한 기술 정보는 src/services/INTERCOM_API_NOTES.md 참조하세요. 이 문서에서는 매개변수 매핑, Intercom 엔드포인트 사용법, 그리고 개발자를 위한 구현 세부 정보를 설명합니다.

개발

# Clone and install dependencies
git clone https://github.com/raoulbia-ai/mcp-server-for-intercom.git
cd mcp-server-for-intercom
npm install

# Build and run for development
npm run build
npm run dev

# Run tests
npm test

부인 성명

이 프로젝트는 독립적인 통합 프로젝트이며 Intercom Inc.와 제휴 관계가 없고, 공식적으로 연결되거나 보증을 받지 않았습니다. "Intercom"은 Intercom Inc.의 등록 상표입니다.

특허

이 프로젝트는 Apache License 2.0에 따라 라이선스가 부여되었습니다. 자세한 내용은 LICENSE 파일을 참조하세요.