18дел Документация

Интеграции

Справочник инструментов MCP

Все 18 инструментов и их параметры из действующего сервера.

Инструменты обнаруживаются клиентом при подключении. Доступ зависит от текущих прав владельца токена.

Доступные очереди и эффективные права на них. Права: Любой участник; только доступные очереди.

list_queues

List queues and their identifiers.

{
  "properties": {},
  "title": "list_queuesArguments",
  "type": "object"
}

Статусы доступных очередей. Права: Право чтения соответствующей очереди.

list_statuses

List workflow statuses per queue, required before moving tasks.

{
  "properties": {},
  "title": "list_statusesArguments",
  "type": "object"
}

Участники текущего пространства. Права: Участник пространства.

list_users

List users eligible as assignees.

{
  "properties": {},
  "title": "list_usersArguments",
  "type": "object"
}

Поиск задач по тексту и фильтрам, до 2000 результатов. Права: Чтение выбранных очередей.

search_issues

Search tasks. Filters: search, queue_ids, status_ids, assignee_ids, mine, priority, category, overdue, label. Maximum 2000 tasks.

{
  "properties": {
    "filters": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Filters"
    }
  },
  "title": "search_issuesArguments",
  "type": "object"
}

Задача с комментариями, временем, историей, доступными связями и подзадачами. Права: Чтение очереди задачи.

get_issue

Read a task, comments, worklogs, history and links.

{
  "properties": {
    "key": {
      "title": "Key",
      "type": "string"
    }
  },
  "required": [
    "key"
  ],
  "title": "get_issueArguments",
  "type": "object"
}

Создать задачу в указанной очереди. Права: Read-write или admin очереди.

create_issue

Create a task. Required queue_id and title. Optional description, assignee_id, priority, labels, due_date, estimate_minutes, parent_id.

{
  "properties": {
    "data": {
      "additionalProperties": true,
      "title": "Data",
      "type": "object"
    }
  },
  "required": [
    "data"
  ],
  "title": "create_issueArguments",
  "type": "object"
}

Изменить поля задачи или переместить в статус её очереди. Права: Read-write или admin очереди.

update_issue

Edit task or move using status_id and position. Include version for optimistic concurrency checking.

{
  "properties": {
    "key": {
      "title": "Key",
      "type": "string"
    },
    "changes": {
      "additionalProperties": true,
      "title": "Changes",
      "type": "object"
    }
  },
  "required": [
    "key",
    "changes"
  ],
  "title": "update_issueArguments",
  "type": "object"
}

Добавить комментарий от имени владельца токена. Права: Read-write или admin очереди.

add_comment

Post a comment as the token owner.

{
  "properties": {
    "key": {
      "title": "Key",
      "type": "string"
    },
    "body": {
      "title": "Body",
      "type": "string"
    }
  },
  "required": [
    "key",
    "body"
  ],
  "title": "add_commentArguments",
  "type": "object"
}

Записать от 1 до 1440 целых минут работы. Права: Read-write или admin очереди.

log_time

Record 1–1440 minutes of work against a task.

{
  "properties": {
    "key": {
      "title": "Key",
      "type": "string"
    },
    "minutes": {
      "title": "Minutes",
      "type": "integer"
    },
    "description": {
      "default": "",
      "title": "Description",
      "type": "string"
    }
  },
  "required": [
    "key",
    "minutes"
  ],
  "title": "log_timeArguments",
  "type": "object"
}

Создать очередь со стандартными статусами. Права: Администратор пространства.

create_queue

Create a queue with default workflow columns.

{
  "properties": {
    "key": {
      "title": "Key",
      "type": "string"
    },
    "name": {
      "title": "Name",
      "type": "string"
    },
    "description": {
      "default": "",
      "title": "Description",
      "type": "string"
    }
  },
  "required": [
    "key",
    "name"
  ],
  "title": "create_queueArguments",
  "type": "object"
}

Статистика доступных задач: прогресс, время, очереди, исполнители; truncated сообщает об усечении. Права: Чтение соответствующих очередей.

queue_statistics

Calculate statistics for selected queues, assignees or other search filters.

{
  "properties": {
    "filters": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Filters"
    }
  },
  "title": "queue_statisticsArguments",
  "type": "object"
}

Доступные общие дашборды с конфигурацией виджетов. Права: Участник; дашборды со скрытыми очередями не выдаются.

list_dashboards

List shared dashboards with widget configuration.

{
  "properties": {},
  "title": "list_dashboardsArguments",
  "type": "object"
}

Создать дашборд, максимум 30 виджетов. Права: Участник, только доступные очереди в фильтрах.

Для изменения передайте dashboard_id: изменить дашборд может его автор. При создании dashboard_id не нужен.

save_dashboard

Create or update own dashboard. Widgets: {type: stats|issues|statuses|queues|time|assignees,title,filters:{queue_ids:[...]}}.

{
  "properties": {
    "name": {
      "title": "Name",
      "type": "string"
    },
    "widgets": {
      "items": {},
      "title": "Widgets",
      "type": "array"
    },
    "dashboard_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Dashboard Id"
    }
  },
  "required": [
    "name",
    "widgets"
  ],
  "title": "save_dashboardArguments",
  "type": "object"
}

Участники, явные/наследуемые роли и история прав очереди. Права: Admin очереди или пространства.

get_queue_permissions

Queue admins: list explicit and inherited access, with audit history.

{
  "properties": {
    "queue_id": {
      "title": "Queue Id",
      "type": "integer"
    }
  },
  "required": [
    "queue_id"
  ],
  "title": "get_queue_permissionsArguments",
  "type": "object"
}

Выдать или изменить роль на очереди. Роль применяется сразу. Права: Admin очереди или пространства; пользователь того же пространства.

set_queue_permission

Queue admins: grant read-only, read-write or admin to a workspace user.

{
  "properties": {
    "queue_id": {
      "title": "Queue Id",
      "type": "integer"
    },
    "user_id": {
      "title": "User Id",
      "type": "integer"
    },
    "role": {
      "title": "Role",
      "type": "string"
    }
  },
  "required": [
    "queue_id",
    "user_id",
    "role"
  ],
  "title": "set_queue_permissionArguments",
  "type": "object"
}

Отозвать явный доступ. Администраторы пространства сохраняют наследуемый admin. Права: Admin очереди или пространства.

revoke_queue_permission

Queue admins: revoke explicit queue access. Space admins always inherit admin.

{
  "properties": {
    "queue_id": {
      "title": "Queue Id",
      "type": "integer"
    },
    "user_id": {
      "title": "User Id",
      "type": "integer"
    }
  },
  "required": [
    "queue_id",
    "user_id"
  ],
  "title": "revoke_queue_permissionArguments",
  "type": "object"
}

Изменить название и описание очереди. Права: Admin очереди или пространства.

update_queue

Queue admins: change queue name and description.

{
  "properties": {
    "queue_id": {
      "title": "Queue Id",
      "type": "integer"
    },
    "changes": {
      "additionalProperties": true,
      "title": "Changes",
      "type": "object"
    }
  },
  "required": [
    "queue_id",
    "changes"
  ],
  "title": "update_queueArguments",
  "type": "object"
}

Изменить имя, роль или активность пользователя. Последний активный admin защищён. Права: Только администратор пространства.

update_user

Space admins: set member/admin workspace role, name or active status.

{
  "properties": {
    "user_id": {
      "title": "User Id",
      "type": "integer"
    },
    "changes": {
      "additionalProperties": true,
      "title": "Changes",
      "type": "object"
    }
  },
  "required": [
    "user_id",
    "changes"
  ],
  "title": "update_userArguments",
  "type": "object"
}