Step 4 of 5

Настройки инструмента

Задайте имя инструмента, описание для LLM и определите входную/выходную схему. Описание — главный сигнал, по которому модель решает, вызывать ли этот инструмент.

Параметры инструмента

Имя инструмента и описание его назначения

Имя инструмента обязательно

Техническое имя для вызова MCP инструмента. Допустимы только строчные английские буквы, цифры и подчеркивания. После публикации изменить нельзя.

Отображаемое имя обязательно

Понятное название, которое отображается в интерфейсе и логах.

Короткое описание (необязательно)

Короткая фраза, которая будет показана MCP клиенту в описании инструмента.

Описание обязательно

Описание для модели. Пишите точно: по этому тексту модель решает, когда нужно вызвать инструмент.

Как писать хорошие описания

Начинайте с глагола: создает, получает, обновляет. Укажите обязательные входные данные и опишите успешный результат. Избегайте расплывчатых формулировок вроде “обрабатывает” или “управляет”.

Входная схема

Параметры, которые LLM передает при вызове инструмента

JSON Schema draft-07

json / input-schema
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": ["first_name", "last_name", "email"],
  "properties": {
    "first_name": { "type": "string", "description": "Contact first name" },
    "last_name":  { "type": "string", "description": "Contact last name" },
    "email":      { "type": "string", "format": "email", "description": "Primary contact email address" },
    "company":    { "type": "string", "description": "Company or organisation name" },
    "phone":      { "type": "string", "description": "Phone number in E.164 format" },
    "source":     { "type": "string", "enum": ["web","api","import"], "default": "api" }
  },
  "additionalProperties": false
}

Выходная схема

Форма данных, которые LLM получает после успешного вызова

JSON Schema draft-07

json / output-schema
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "lead_id":    { "type": "string", "description": "Unique identifier of the created lead" },
    "status":     { "type": "string", "description": "Initial lead status assigned by the CRM" },
    "created_at": { "type": "string", "format": "date-time" },
    "owner_id":   { "type": "string", "description": "CRM user ID of the assigned owner" }
  }
}

Схемы описывают инструмент

Входная схема описывает данные, которые MCP клиент передает инструменту. Выходная схема описывает результат работы инструмента. На следующем шаге эти поля связываются с реальным API-запросом и ответом.