Skip to main content
Glama

Сопоставление полей amoCRM

manage_quiz_amocrm_mapping
Destructive

Сопоставление полей опроса с полями amoCRM. Форма здесь другая, чем у Bitrix24: вместо «сущность → поля» задаётся, что активно, и словари по номерам. Блок deal — сделки в перечисленных воронках, list — контакт (0), компания (1) и каталоги, task — задачи. Задаётся по одному блоку за вызов, блок заменяется целиком, остальные не трогаются. Каждое значение проверяется по живым справочникам портала до записи: воронка существует, стадия принадлежит этой воронке, поле есть в справочнике, ответственный есть в списке. Имена полей и номера воронок смотрите через get_quiz_crm_fields, идентификаторы вопросов — в quiz://{id}/structure. Bitrix24 настраивается отдельным инструментом manage_quiz_crm_mapping.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "quiz_id": "<quiz_id>",
      "block": "<block>"
    },
    "name": "manage_quiz_amocrm_mapping"
  }
}

Input Schema

NameRequiredDescriptionDefault
bindNoСопоставление: ключ — числовой ID поля amoCRM из справочника, значение — ID вопроса опроса. Постоянные значения эта форма не поддерживает.
blockYesЧто настраиваем: deal — сделки, list — контакт, компания и каталоги, task — задачи.
usersNoОтветственный по каждому номеру воронки.
activeNoЧто включено: для deal — номера воронок, для list — 0 (контакт), 1 (компания) и номера каталогов, для task — номера воронок. Пустой список означает «не создавать».
titlesNoНазвание по каждому номеру из active: либо ID вопроса опроса, либо готовый текст. Если название не собралось, amoCRM подставит «Lead #номер».
quiz_idYesID опроса.
subtypeNoУточнение вида значения для составного поля (например, какой это телефон). Ключ — тот же ID поля, что в bind.
statusesNoСтадия по каждому номеру воронки. Стадия должна принадлежать своей воронке.
use_priceNoОтправлять ли в сумму сделки набранные баллы — по каждому номеру воронки.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructiveHint=true, readOnlyHint=false and openWorldHint=true; the description goes beyond them by explaining what is destroyed ('блок заменяется целиком, остальные не трогаются') and that every value is validated against live portal directories before writing (pipeline exists, stage belongs to that pipeline, field exists, assignee exists). It does not cover failure handling or whether a rejected value aborts the whole block, which keeps it from a 5.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose is front-loaded, followed by the shape difference, the block model, then validation and references — a sensible order with no filler sentences. It is dense with domain details, but every clause carries operational information for a 9-parameter tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a destructive, nested-object write tool with no output schema, the definition covers the essential model: one block per call, full replacement, per-block validation, and where to fetch valid identifiers. Gaps remain around error behavior and permissions, but nothing critical for correct invocation is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds cross-parameter meaning the schema states only piecemeal: active numbers are pipelines for deal/task and 0/1/catalog numbers for list, and statuses must belong to their own pipeline. It restates a few things already in the schema (e.g. the «Lead #номер» fallback) rather than deepening them.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The first sentence names a specific verb and resource (mapping survey fields to amoCRM fields), and the second immediately distinguishes this tool's data shape from the Bitrix24 variant ('вместо «сущность → поля» задаётся, что активно, и словари по номерам'). The block taxonomy (deal/list/task) further pins down what is being configured, so an agent can tell this apart from the Bitrix24 sibling without opening the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It states the operational constraint ('Задаётся по одному блоку за вызов'), the replacement semantics, and routes the agent elsewhere when appropriate: 'Bitrix24 настраивается отдельным инструментом manage_quiz_crm_mapping'. It also names prerequisites for the required values — field names and pipeline numbers via get_quiz_crm_fields, question IDs via quiz://{id}/structure — which is exactly the when-and-how guidance an agent needs.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources