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"
}
}
}
}Claude и ChatGPT (вход)
Добавьте адрес подключения в качестве пользовательского коннектора в Claude или в качестве пользовательского MCP-сервера в ChatGPT. Они откроют ваш сайт, чтобы вы могли подтвердить их в качестве пользователя WordPress, без необходимости копировать пароль приложения. Для вашего сайта требуются понятные постоянные ссылки.
Другие приложения
Любое приложение, поддерживающее серверы MCP через стандартные ввод и вывод, может использовать ту же команду и те же настройки. Приложения, подключающиеся только к удаленным серверам HTTP, могут обращаться по адресу подключения напрямую с теми же именем пользователя и паролем приложения.
На что способен ИИ-агент
Всё, что могут собственные экраны плагина. Действия, отмеченные значком 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.