Intercom용 MCP 서버

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

특징

• 고급 필터링으로 대화 및 티켓 검색
• 고객, 상태, 날짜 범위 및 키워드로 필터링
• 연락처가 없어도 이메일 내용으로 검색
• Intercom의 검색 API를 통한 효율적인 서버 측 필터링
• MCP 호환 AI 어시스턴트와의 원활한 통합

설치

필수 조건

• Node.js 18.0.0 이상
• API 액세스가 가능한 Intercom 계정
• Intercom API 토큰(Intercom 계정 설정에서 사용 가능)

빠른 설정

NPM 사용하기

지엑스피1

Docker 사용

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

검증 단계:

대체 표준 버전

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

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

사용 가능한 MCP 도구

1. list_conversations

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

매개변수:

• startDate (DD/MM/YYYY) – 시작일(필수)
• endDate (DD/MM/YYYY) – 종료 날짜(필수)
• keyword (문자열) – 이 텍스트가 포함된 대화를 포함하도록 필터링합니다.
• exclude (문자열) – 이 텍스트가 포함된 대화를 제외하기 위한 필터

참고사항:

• 날짜 범위는 7일을 초과할 수 없습니다.
• Intercom의 검색 API를 통해 효율적인 서버 측 필터링을 사용합니다.

예:

2. search_conversations_by_customer

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

매개변수:

• customerIdentifier (문자열) – 고객 이메일 또는 Intercom ID(필수)
• startDate (DD/MM/YYYY) – 선택 시작일
• endDate (DD/MM/YYYY) – 선택적인 종료 날짜
• keywords (배열) – 콘텐츠로 필터링할 선택적 키워드

참고사항:

• 연락처가 없더라도 이메일 내용으로 대화를 찾을 수 있습니다.
• 효율적인 검색을 위해 이메일을 연락처 ID로 변환합니다.

예:

3. search_tickets_by_status

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

매개변수:

• status (문자열) – "열림", "보류 중" 또는 "해결됨"(필수)
• startDate (DD/MM/YYYY) – 선택 시작일
• endDate (DD/MM/YYYY) – 선택적인 종료 날짜

예:

4. search_tickets_by_customer

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

매개변수:

• customerIdentifier (문자열) – 고객 이메일 또는 Intercom ID(필수)
• startDate (DD/MM/YYYY) – 선택 시작일
• endDate (DD/MM/YYYY) – 선택적인 종료 날짜

예:

Claude Desktop을 사용한 구성

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

구현 노트

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

개발

부인 성명

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

특허

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