@theyahia/amocrm-mcp

프로덕션 등급의 amoCRM API용 MCP 서버입니다. 리드, 연락처, 회사, 파이프라인, 작업, 메모, 검색, 이벤트, 미분류 리드를 다루는 19가지 도구를 제공합니다. 자동 토큰 갱신 기능이 있는 OAuth 2.0. 속도 제한(초당 7회 요청). 지수 백오프를 사용한 재시도.

설치

npx -y @theyahia/amocrm-mcp

Related MCP server: amocrm-mcp

MCP 구성

Claude Desktop, Cursor 또는 모든 MCP 클라이언트 구성에 추가하세요:

{
  "mcpServers": {
    "amocrm": {
      "command": "npx",
      "args": ["-y", "@theyahia/amocrm-mcp"],
      "env": {
        "AMOCRM_SUBDOMAIN": "mycompany",
        "AMOCRM_ACCESS_TOKEN": "your-access-token",
        "AMOCRM_REFRESH_TOKEN": "your-refresh-token",
        "AMOCRM_CLIENT_ID": "your-client-id",
        "AMOCRM_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

환경 변수

AMOCRM_DOMAIN도 AMOCRM_SUBDOMAIN의 별칭으로 허용됩니다(하위 호환성).

도구 (19)

리드

연락처

회사

파이프라인

작업

미분류

메모

검색

이벤트

계정

데모 프롬프트

영업 개요:

"'Sales' 파이프라인에서 현재 'Negotiation' 단계에 있는 모든 리드를 보여줘. 연락처 정보도 포함해 줘."

작업 관리:

"리드 #12345에 대한 후속 통화 작업을 만들어 줘. 마감은 내일 오전 10시. 그런 다음 내 미완료 작업을 모두 나열해 줘."

신규 고객 온보딩:

"'Ivan Petrov'라는 연락처를 전화번호 +79001234567로 만들고, 'Petrov Solutions' 회사를 만든 다음, 기본 파이프라인에 150,000 RUB 상당의 'Website Development' 리드를 만들어 줘."

OAuth 2.0 설정 가이드

1. amoCRM 계정 설정으로 이동합니다: https://YOUR_SUBDOMAIN.amocrm.ru/settings/widgets/

2. 새 통합(외부 통합)을 생성합니다

3. 리디렉션 URI를 https://YOUR_SUBDOMAIN.amocrm.ru로 설정합니다

4. 클라이언트 ID와 클라이언트 시크릿을 복사합니다

5. 초기 인증 코드를 얻기 위해 통합을 승인합니다

6. 코드를 토큰으로 교환합니다:

curl -X POST https://YOUR_SUBDOMAIN.amocrm.ru/oauth2/access_token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "grant_type": "authorization_code",
    "code": "YOUR_AUTH_CODE",
    "redirect_uri": "https://YOUR_SUBDOMAIN.amocrm.ru"
  }'

7. 응답에서 access_token과 refresh_token을 저장합니다

8. AMOCRM_REFRESH_TOKEN, AMOCRM_CLIENT_ID, AMOCRM_CLIENT_SECRET이 설정된 경우 서버는 만료된 토큰을 자동으로 갱신합니다

오류 처리

• 401 Unauthorized: 갱신 자격 증명이 구성된 경우 토큰을 자동 갱신한 후 재시도합니다

• 429 Rate Limited: Retry-After 헤더를 존중하고 대기 후 재시도합니다

• 5xx Server Errors: 지수 백오프 재시도(최대 3회)

• Rate Limiting: amoCRM 한도 내에서 유지하기 위해 요청 간 150ms 지연이 내장되어 있습니다(초당 약 7회)

개발

git clone https://github.com/theYahia/amocrm-mcp.git
cd amocrm-mcp
npm install
npm run build
npm test

라이선스

MIT