AI-агенты (MCP)
Zinn® Chat для ИИ-агентов
Ваш сайт на базе WordPress является собственным MCP-сервером. ИИ-ассистент входит в систему как пользователь WordPress с паролем приложения и может выполнять с Zinn® Chat то, что разрешено этому пользователю — не более того.
36 действий: 21 бесплатных, 15 в Pro.
Справочник разработчика: каждое действие, его REST-маршрут и параметры
Та же инструкция в нашей базе знаний со списком всех бесплатных действий
Настройте это за три шага
Проверить переключатель
Для работы требуется WordPress 6.9 или новее и Zinn® Chat версии 2.9.0 или новее. В настройках плагина параметр «Allow AI agents (MCP)» включен, если только вы его не отключили.
Создать пароль приложения
В WordPress откройте раздел «Пользователи», затем «Профиль» и добавьте пароль приложения, назвав его в честь вашего ИИ-приложения. Скопируйте его: WordPress отображает его только один раз.
Добавить сайт в ваше ИИ-приложение
Используйте свое имя пользователя WordPress, пароль приложения и адрес подключения вашего сайта:
https://example.com/wp-json/zinn-chat/v1/mcp
Настройка для популярных ИИ-приложений
Каждое приложение ниже взаимодействует с вашим сайтом через официальный прокси WordPress, @automattic/mcp-wordpress-remote. Замените адрес, имя пользователя и пароль своими данными.
Claude Desktop
// claude_desktop_config.json
{
"mcpServers": {
"zinn-chat": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Claude Code
claude mcp add zinn-chat \
-e WP_API_URL=https://example.com/wp-json/zinn-chat/v1/mcp \
-e WP_API_USERNAME=your-username \
-e WP_API_PASSWORD=your-application-password \
-- npx -y @automattic/mcp-wordpress-remote@latestКурсор
// .cursor/mcp.json
{
"mcpServers": {
"zinn-chat": {
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}VS Code
// .vscode/mcp.json — VS Code's key is "servers"
{
"servers": {
"zinn-chat": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@automattic/mcp-wordpress-remote@latest"
],
"env": {
"WP_API_URL": "https://example.com/wp-json/zinn-chat/v1/mcp",
"WP_API_USERNAME": "your-username",
"WP_API_PASSWORD": "your-application-password"
}
}
}
}Другие приложения
Любое приложение, поддерживающее серверы MCP через стандартный ввод и вывод, может использовать ту же команду и настройки. Приложения, которые подключаются только к удаленным серверам HTTP, могут обращаться к адресу подключения напрямую с тем же именем пользователя и паролем приложения. ChatGPT является исключением на данный момент: он подключается к серверам MCP только посредством входа через OAuth, поэтому он не может использовать пароль приложения.
На что способен ИИ-агент
Всё, что могут собственные экраны плагина. Действия, отмеченные значком Pro, требуют лицензии Zinn® Chat Pro.
| Действие | Назначение | Редакция |
|---|---|---|
| Ответить на тикет | Отвечает клиенту по электронной почте (текст) или добавляет внутреннюю заметку (note: true); статус при необходимости меняет статус тикета. | Бесплатный тариф |
| Спросить ассистента | Задает сайтовому ИИ-ассистенту вопрос и возвращает его ответ со всеми найденными источниками. | Бесплатный тариф |
| Массовое изменение тикетов (Pro) | Изменяет статус, приоритет или ответственного для не более чем 100 тикетов (по их id). Каждый тикет проходит те же проверки, что и при изменении по отдельности; результат выводится для каждого из них. | Версия Pro |
| Превратить чат в тикет | Открывает тикет из чата для ответа по электронной почте (требуется адрес электронной почты посетителя). | Бесплатный тариф |
| Закрыть чат | Завершает чат; посетитель по-прежнему может запросить стенограмму. | Бесплатный тариф |
| Открыть тикет | Открывает тикет от имени клиента (его электронная почта, тема и первое сообщение). | Бесплатный тариф |
| Удалить сохраненный ответ (Pro) | Удаляет сохраненный ответ. | Версия Pro |
| Удалить тикет | Безвозвратно удаляет тикет и всю переписку по нему (доступно только менеджерам). | Бесплатный тариф |
| Создать справочную статью на основе тикета (Pro) | Создает черновик статьи базы знаний из решенного тикета; он остается черновиком, пока его не опубликует человек. | Версия Pro |
| Черновики справочных статей для вопросов без ответов (Pro) | Создает черновики статей базы знаний, отвечающие на выбранные вопросы (ids); они остаются черновиками. | Версия Pro |
| Заполнить сохраненным ответом (Pro) | Возвращает текст сохраненного ответа с заполненными заполнителями для одного чата или тикета. | Версия Pro |
| Читать чат | Возвращает сообщения одного чата и данные посетителя (after: только сообщения новее этого ID). | Бесплатный тариф |
| Ознакомиться с обзором службы поддержки | Возвращает количество тикетов в каждом статусе, количество чатов, ожидающих оператора (и их непрочитанные сообщения), а также информацию о том, включены ли чат, ассистент и тикеты. | Бесплатный тариф |
| Прочитать настройки чата | Возвращает все настройки чата: виджет, ассистент, сотрудники и часы работы, тикеты и электронная почта, индекс сайта, конфиденциальность и спам. | Бесплатный тариф |
| Просмотр статистики поддержки (Pro) | Возвращает количество чатов и тикетов, время ответа и оценки за последние N дней (days). | Версия Pro |
| Прочитать тикет | Возвращает один тикет со всей перепиской, статусом, приоритетом и назначенным исполнителем. | Бесплатный тариф |
| Вернуть чат ассистенту | Возвращает чат с ИИ-ассистентом, который отвечает посетителям на основе контента сайта. | Бесплатный тариф |
| Список сохраненных ответов (Pro) | Отображает список сохраненных ответов, которые агенты могут вставлять, с указанием их ярлыков. | Версия Pro |
| Список активных чатов | Отображает список ожидающих, текущих и недавно закрытых чатов с указанием того, кто ведет каждый из них. | Бесплатный тариф |
| Перечислить, что известно ассистенту | Выводит список контента, на который отвечает ассистент, с указанием статуса индексации, по одной странице за раз. | Бесплатный тариф |
| Список без ответа (Pro) | Отображает список вопросов посетителей, на которые база знаний не смогла ответить. | Версия Pro |
| Список тикетов | Выводит список обращений в службу поддержки, отфильтрованных по статусу или поисковому запросу, постранично. | Бесплатный тариф |
| Перестроить поисковый индекс помощника | Перестраивает поисковые векторы для одного элемента (item_id) или для всех (all: true) (только для менеджеров). | Бесплатный тариф |
| Повторно прочитать содержимое для помощника | Повторно индексирует один элемент (item_id) или все элементы (all: true) в индекс ассистента (только для менеджеров). | Бесплатный тариф |
| Ответить в чате | Отправляет сообщение посетителю (text) или добавляет внутреннюю заметку, видимую только агентам (note: true). | Бесплатный тариф |
| Сохранить сохраненный ответ (Pro) | Создает или изменяет сохраненный ответ (заголовок, ярлык, текст, отдел; id для изменения существующего). | Версия Pro |
| Написать справку (Pro) | Создает статью базы знаний или изменяет ее (id): заголовок, содержание, отрывок, категории и статус (черновик или опубликовано, когда публикация разрешена). | Версия Pro |
| Поиск по базе знаний (Pro) | Находит справочные статьи для добавления ссылки в ответ (q: поиск). | Версия Pro |
| Назначить отдел и теги беседы (Pro) | Устанавливает отдел и теги чата или тикета (тип: chat или ticket; id). | Версия Pro |
| Помечать неотвеченные вопросы (Pro) | Помечает неотвеченные вопросы как открытые, запланированные или отклоненные (идентификаторы, статус). | Версия Pro |
| Установить доступность | Указывает, доступен ли вошедший в систему агент или отсутствует для новых чатов (away: true или false). | Бесплатный тариф |
| Сгенерировать ответ с помощью ИИ (Pro) | Создает проект ответа на чат или тикет на основе контента сайта; ничего не отправляется. | Версия Pro |
| Суммировать беседу с ИИ (Pro) | Суммирует чат или тикет в нескольких строках. | Версия Pro |
| Начать чат | Назначает чат из очереди вошедшему в систему оператору, чтобы посетитель общался с человеком. | Бесплатный тариф |
| Изменить настройки чата | Изменяет отправляемые настройки (настройки: ключ и значение) и сохраняет остальные. Каждое значение проверяется точно так же, как на экране настроек; get-settings выводит список ключей. | Бесплатный тариф |
| Изменить тикет | Изменяет статус, приоритет или ответственного за обращение. | Бесплатный тариф |
Безопасно по определению
Каждое действие проверяет те же права WordPress, что и собственный экран плагина, для конкретной страницы или записи, к которой оно применяется. Подписчик не сможет подключиться вообще.
Пароли приложений можно отозвать в любое время в разделе «Пользователи» > «Профиль», не меняя ваш основной пароль.
Отключите параметр «Разрешить агентам ИИ (MCP)», и действия вместе с адресом подключения исчезнут с сайта.
Страницы, измененные агентом, сохраняют свои ревизии WordPress, поэтому любые изменения можно отменить.
Размещено на Zinn Digital®?
Если Zinn Digital® размещает сайт, наш собственный сервер MCP может выполнить эти действия за вас без пароля приложения: подключите свое ИИ-приложение к серверу MCP Zinn Digital® и используйте wordpress_abilities_list и wordpress_ability_run.