Расположение конфига
Для одного проекта — .cursor/mcp.json в его корне, для всех проектов — ~/.cursor/mcp.json. Cursor перечитывает файл при перезапуске; состояние серверов отображается в Settings → MCP вместе с ошибками запуска.
Cursor
Подключение к Cursor
Конфигурация через mcp.json — на уровне проекта или пользователя.
Хранение ключа
Проектный конфиг обычно попадает в git, поэтому ключ стоит держать в переменной окружения и подставлять её, а не записывать значение в файл. Альтернатива — положить конфиг в пользовательский каталог.
Вариант без npx
Если ставить пакет локально нежелательно, используйте HTTP-транспорт: тот же сервер доступен по удалённому эндпоинту, ключ передаётся заголовком Authorization.
.cursor/mcp.json
{
"mcpServers": {
"1-chat": {
"command": "npx",
"args": ["-y", "@1-chat/mcp"],
"env": {
"ONECHAT_API_KEY": "sk-1chat-..."
}
}
}
}Инструменты
list_chats(channel?: Channel, unread_only?: boolean, limit?: number)→ Chat[]- Диалоги по всем подключённым каналам с курсорной пагинацией. Без фильтра возвращает объединённый список.
send_message(chat_id: string, text: string, reply_to?: string)→ Message- Отправка в существующий диалог. reply_to делает сообщение ответом на конкретное входящее.
send_media(chat_id: string, url?: string, base64?: string, caption?: string)→ Message- Изображение, документ или аудио. Источник — публичная ссылка либо base64. До 25 МБ на файл.
search_contacts(query: string, channel?: Channel)→ Contact[]- Поиск по имени, телефону и юзернейму во всех каналах одним запросом. Совпадения дедуплицируются по контакту.
Частые вопросы
Подключите агента к мессенджерам
Выпустите ключ, добавьте пять строк в конфиг — и агент начнёт писать клиентам сам.
Есть вопросы? Напишите нам в Telegram →