MCP-сервер для Iaptic

Сервер протокола Model Context Protocol (MCP) для взаимодействия с API Iaptic. Этот сервер позволяет Claude или другим ИИ взаимодействовать с вашими данными Iaptic, чтобы отвечать на вопросы о ваших клиентах, покупках, транзакциях и статистике.

Установка

Установка через Smithery

Чтобы автоматически установить Iaptic для Claude Desktop через Smithery:

npx -y @smithery/cli install mcp-server-iaptic --client claude

Ручная установка

# Run directly with npx
npx mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

# Or install globally
npm install -g mcp-server-iaptic
mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

Related MCP server: MCP Unified Server

Использование с Claude Desktop

Добавьте в файл конфигурации Claude Desktop:

{
  "iaptic": {
    "command": "npx",
    "args": [
      "mcp-server-iaptic",
      "--api-key", "your-api-key-here",
      "--app-name", "your-app-name-here"
    ]
  }
}

Доступные инструменты

Клиенты

• customer_list: Список клиентов с пагинацией

• customer_get: Получение подробной информации о клиенте по ID

• customer_subscription: Получение статуса активной подписки клиента

• customer_transactions: Получение истории транзакций клиента

• customer_add_purchase: Ручное добавление покупки клиенту

Покупки

• purchase_list: Список покупок

  • limit: Максимальное количество возвращаемых покупок (по умолчанию: 100, макс.: 1000)

  • offset: Количество покупок, которые нужно пропустить для пагинации

  • startdate: Фильтр покупок после этой даты (формат ISO, например, 2024-01-01)

  • enddate: Фильтр покупок до этой даты (формат ISO, например, 2024-12-31)

  • customerId: Фильтр по ID клиента

• purchase_get: Получение деталей покупки по ID

Транзакции

• transaction_list: Список транзакций с пагинацией и фильтрацией по дате

  • limit: Максимальное количество возвращаемых транзакций (по умолчанию: 100, макс.: 1000)

  • offset: Количество транзакций, которые нужно пропустить для пагинации

  • startdate: Фильтр транзакций после этой даты (формат ISO, например, 2024-01-01)

  • enddate: Фильтр транзакций до этой даты (формат ISO, например, 2024-12-31)

  • purchaseId: Фильтр по ID покупки

• transaction_get: Получение деталей транзакции по ID

Статистика

• stats_get: Получение общей статистики по транзакциям и доходу

• stats_app: Получение статистики по конкретному приложению

События

• event_list: Список последних событий с пагинацией и фильтрацией по дате

  • limit: Максимальное количество возвращаемых событий (по умолчанию: 100)

  • offset: Количество событий, которые нужно пропустить для пагинации

  • startdate: Фильтр событий после этой даты (формат ISO, например, 2024-01-01)

  • enddate: Фильтр событий до этой даты (формат ISO, например, 2024-12-31)

  • raw: Возврат необработанного JSON вместо отформатированного вывода (по умолчанию: false)

• event_details: Получение подробной информации о конкретном событии (валидатор 3.12+)

  • eventId: ID события, информацию о котором нужно получить

  • receipts: Включить детали валидации чека (по умолчанию: false)

Stripe

• stripe_prices: Получение доступных продуктов и цен Stripe

Управление приложением

• iaptic_switch_app: Переключение на другое приложение Iaptic

  • appName: Название приложения, на которое нужно переключиться

  • apiKey: API-ключ для приложения

• iaptic_reset_app: Сброс до приложения Iaptic по умолчанию

• iaptic_current_app: Получение информации о текущем активном приложении

Разработка

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run production build
npm start

Требования

• Node.js >= 18

• Учетная запись Iaptic с учетными данными API

Лицензия

MIT