MCP Server
mcp-amocrm-server
Garrik24/mcp-amocrm-server
45
InicialPluginScore · de 0 a 100Instalação
$
npx convez-ai Garrik24/mcp-amocrm-server1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Estrelas
2Forks
1Acompanhando
0Saúde
14%Último commit
há 1 mêsVersão
—Issues abertas
0Contribuidores
4README
A tradução para o português deste README ainda está na fila.
AmoCRM MCP Server
Сервер для интеграции с AmoCRM API на базе FastAPI.
🔴 КРИТИЧЕСКИЕ ИЗМЕНЕНИЯ БЕЗОПАСНОСТИ
- Удалены все секретные данные из кода
- Добавлена обязательная проверка переменных окружения
- Создан .gitignore для защиты конфиденциальных данных
Установка и настройка
1. Клонирование репозитория
git clone <your-repo-url>
cd amocrm-mcp-server
2. Установка зависимостей
pip install -r requirements.txt
3. Настройка переменных окружения
Создайте файл .env на основе .env.example:
cp .env.example .env
Заполните переменные вашими данными:
AMOCRM_CLIENT_ID- ID интеграции из AmoCRMAMOCRM_CLIENT_SECRET- Секретный ключ интеграцииAMOCRM_SUBDOMAIN- Поддомен вашего аккаунта AmoCRMREDIRECT_URI- URL для callback (должен совпадать с настройками в AmoCRM)
4. Запуск сервера
Для локальной разработки:
uvicorn app:app --reload --port 8000
Для production (Railway/Heroku):
web: uvicorn app:app --host 0.0.0.0 --port $PORT
API Эндпоинты
Авторизация
GET /auth/authorize- Получить ссылку для OAuth авторизацииGET /callback- Обработка callback от AmoCRMPOST /auth/token- Обмен кода на токеныPOST /auth/refresh- Обновление токенов
Работа с данными
GET /api/account- Информация об аккаунтеPOST /api/entities- Универсальный метод для работы с сущностями
Вебхуки
POST /webhooks/receive- Приём вебхуков от AmoCRM
Новые функции
- Безопасное хранение токенов с поддержкой сессий
- Автоматическое обновление токенов
- Универсальный API для всех сущностей AmoCRM
- Обработка ошибок и логирование
- Поддержка вебхуков
- Документация API (доступна по адресу
/docs)
Безопасность
⚠️ ВАЖНО:
- Никогда не коммитьте файл
.envс реальными данными - Используйте переменные окружения для всех секретных данных
- В production используйте Redis или БД для хранения токенов
Деплой на Railway
- Создайте новый проект на Railway
- Подключите GitHub репозиторий
- Добавьте переменные окружения в настройках проекта:
AMOCRM_CLIENT_IDAMOCRM_CLIENT_SECRETAMOCRM_SUBDOMAINREDIRECT_URI
- Railway автоматически развернёт приложение
Примеры использования
Получение токена
import requests
# 1. Получить ссылку для авторизации
response = requests.get("https://your-domain.com/auth/authorize")
auth_url = response.json()["auth_url"]
# Перейти по ссылке и авторизоваться
# 2. После редиректа получить session_id
# session_id будет в ответе callback
Работа с сущностями
# Получить список сделок
response = requests.post(
"https://your-domain.com/api/entities",
params={"session_id": "your_session_id"},
json={
"entity_type": "leads",
"method": "get",
"params": {"limit": 10}
}
)
Поддержка
При возникновении проблем создайте issue в репозитории.