Amocrm MCP
ภาพรวม
คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)
MCP server for amoCRM API — leads, contacts, pipelines. Auth: Bearer token.
สามเสาของ PopNx MCP
สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน
- เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
- ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
- การใช้งานiยังใหม่มาก↓ 64/สัปดาห์ · ★ –
ใช้ทำอะไรได้
ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry
- การเชื่อมต่อ: รันบนเครื่อง
- ช่องทาง (transport): stdio
- หมวด: การตลาดและโซเชียล
- ต้องใส่ค่าเหล่านี้: AMOCRM_DOMAIN
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ก่อนติดตั้ง
- ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
- รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
- ค่าที่คุณต้องใส่เอง:
AMOCRM_DOMAIN
ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต
ต้องเตรียมก่อน
- npmติดตั้ง Node.js (มีคำสั่ง npx) ในเครื่อง
คุณใช้แอปไหน
เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”
เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json
{
"mcpServers": {
"amocrm": {
"command": "npx",
"args": [
"-y",
"@theyahia/amocrm-mcp"
],
"env": {
"AMOCRM_DOMAIN": "ใส่ค่าของคุณ"
}
}
}
}พิมพ์คำสั่งนี้ใน Terminal
claude mcp add amocrm --env AMOCRM_DOMAIN='ใส่ค่าของคุณ' -- npx -y @theyahia/amocrm-mcpเติมค่าที่เว้นว่างไว้ก่อนรัน
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"amocrm": {
"command": "npx",
"args": [
"-y",
"@theyahia/amocrm-mcp"
],
"env": {
"AMOCRM_DOMAIN": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"amocrm": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/amocrm-mcp"
],
"env": {
"AMOCRM_DOMAIN": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น
ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี
ค่าที่ต้องใส่เอง
- API key for the service
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
ทำอะไรได้บ้าง
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 8 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub theYahia ซึ่งเป็นเจ้าของ repo
- … ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- … ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- – ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
- – ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
เทียบกับตัวอื่นในหมวด การตลาดและโซเชียลi
- ดาวมากกว่า 0% ของอีก 3601 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 4% ของอีก 3601 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 3601 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
Amocrm MCP ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
ต้องใส่ค่าเหล่านี้: AMOCRM_DOMAIN
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (1.0.1) เข้า registry 7 เดือนที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
ตัวที่ใช้แทนได้
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Google Analytics MCP
GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
## 🗄 Репозиторий заархивирован
Разработка переехала в [theYahia/WWmcp](https://github.com/theYahia/WWmcp) — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро
@theyahia/mcp-core, единый CI, единый релизный конвейер.
Актуальная версия того, что лежало здесь:
servers/amocrm/
Пакет в npm прежний —
@theyahia/amocrm-mcp, ставится и работает как раньше.
Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.
Archived — development moved to [theYahia/WWmcp](https://github.com/theYahia/WWmcp), a monorepo of MCP servers for non-Western APIs.
The current version of this package now lives at
servers/amocrm/.
The npm package
@theyahia/amocrm-mcpis unchanged.
Please open issues and pull requests there.
amoCRM MCP — сделки, контакты и воронка продаж через нейросеть
Если вы искали, как подключить amoCRM к ИИ-ассистенту, спросить состояние воронки обычными словами, завести сделку или найти контакт не открывая интерфейс — это оно. 19 инструментов для amoCRM: сделки, контакты, компании, воронки, задачи, примечания, поиск, события и неразобранное. OAuth 2.0 с автообновлением токена, ограничение 7 запросов/сек и повтор с экспоненциальной задержкой.
Установка
npx -y @theyahia/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_SUBDOMAIN | да | Поддомен вашего amoCRM (например, mycompany из mycompany.amocrm.ru) |
AMOCRM_ACCESS_TOKEN | да | OAuth access-токен |
AMOCRM_REFRESH_TOKEN | нет | OAuth refresh-токен (включает автообновление при 401) |
AMOCRM_CLIENT_ID | нет | OAuth client ID (нужен для обновления токена) |
AMOCRM_CLIENT_SECRET | нет | OAuth client secret (нужен для обновления токена) |
AMOCRM_DOMAINтоже принимается как алиасAMOCRM_SUBDOMAIN(обратная совместимость).
Инструменты (19)
Сделки
| Инструмент | Описание |
|---|---|
list_leads | Поиск и список сделок с фильтрами (воронка, статусы, запрос). Подтягивает контакты и причины отказа. |
get_lead | Одна сделка по ID вместе со связанными контактами и элементами каталога. |
create_lead | Создать сделку с названием, бюджетом, воронкой, статусом и пользовательскими полями. |
update_lead | Обновить поля сделки — перевести между этапами, изменить бюджет, сменить ответственного. |
Контакты
| Инструмент | Описание |
|---|---|
list_contacts | Поиск контактов по имени, телефону, e-mail. |
get_contact | Один контакт со всеми пользовательскими полями. |
create_contact | Создать контакт с телефоном, e-mail и пользовательскими полями. |
Компании
| Инструмент | Описание |
|---|---|
list_companies | Поиск компаний. Подтягивает связанные сделки и контакты. |
create_company | Создать компанию с пользовательскими полями. |
Воронки
| Инструмент | Описание |
|---|---|
list_pipelines | Все воронки продаж вместе с их статусами (этапами). |
Задачи
| Инструмент | Описание |
|---|---|
list_tasks | Список задач с фильтрами по сущности, выполненности и ответственному. |
create_task | Создать задачу, привязанную к сделке, контакту или компании, с дедлайном. |
complete_task | Отметить задачу выполненной и добавить текст результата. |
Неразобранное
| Инструмент | Описание |
|---|---|
list_unsorted | Входящие неразобранные заявки (формы, разбор почты). |
accept_unsorted | Принять неразобранную заявку в воронку. |
Примечания
| Инструмент | Описание |
|---|---|
add_note | Добавить примечание (common, call_in, call_out, service_message) к любой сущности. |
Поиск
| Инструмент | Описание |
|---|---|
search | Универсальный поиск по сделкам, контактам и компаниям. |
События
| Инструмент | Описание |
|---|---|
list_events | Лента событий — смены статусов, звонки, примечания, связи. |
Аккаунт
| Инструмент | Описание |
|---|---|
get_account | Информация об аккаунте, пользователи, типы задач, настройки amojo. |
Демо-промпты
Обзор продаж:
«Покажи все сделки в воронке „Продажи“, которые сейчас на этапе „Переговоры“. С контактами.»
Работа с задачами:
«Создай задачу-перезвон по сделке #12345, дедлайн завтра в 10:00. Потом выведи все мои невыполненные задачи.»
Заведение нового клиента:
«Создай контакт „Иван Петров“ с телефоном +79001234567, потом компанию „Петров Солюшнс“ и сделку „Разработка сайта“ на 150 000 рублей в основной воронке.»
Как настроить OAuth 2.0
- Откройте настройки аккаунта amoCRM:
https://YOUR_SUBDOMAIN.amocrm.ru/settings/widgets/ - Создайте новую интеграцию (внешняя интеграция)
- Укажите redirect URI:
https://YOUR_SUBDOMAIN.amocrm.ru - Скопируйте Client ID и Client Secret
- Авторизуйте интеграцию, чтобы получить первичный код авторизации
- Обменяйте код на токены:
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" }'
- Сохраните
access_tokenиrefresh_tokenиз ответа - Сервер сам обновит просроченный токен, если заданы
AMOCRM_REFRESH_TOKEN,AMOCRM_CLIENT_IDиAMOCRM_CLIENT_SECRET
Обработка ошибок
- 401 Unauthorized — автообновление токена, если настроены реквизиты для refresh, затем повтор запроса
- 429 Rate Limited — учитывает заголовок
Retry-After, ждёт и повторяет - 5xx — повтор с экспоненциальной задержкой (до 3 попыток)
- Ограничение частоты — встроенная пауза 150 мс между запросами (~7 запросов/сек), чтобы укладываться в лимиты amoCRM
Разработка
git clone https://github.com/theYahia/amocrm-mcp.git
cd amocrm-mcp npm install npm run build npm test
Лицензия
MIT
Telegram: @vhodvai