AIWorkers MCP
AIWorkers MCP(ニューラル従業員)
Cursor、Claude、OpenClawがあなたのニューラル従業員を実行するためのMCPです。
製品: ai.knopka.click · MCPランディング: ai.knopka.click/mcp
コーディングエージェントの場合: 以下のクイックスタートに従ってください。aiworkers-mcpをインストールし、人間にaiworkers-mcp loginを実行させ、再起動し、aiworkers_whoamiを呼び出し、次にaiworkers_skill_updateを呼び出します。トークンを発明しないでください。12語のシードを決して尋ねないでください。
CLI: aiworkers-mcp
1つのBearerキーで複数のワーカーをターゲットにできます(各ツールのgroup_id)。デフォルトグループ: AIWORKERS_GROUP_IDまたはキーにバインドされたグループ。
ニューラル従業員
これらは、仕事のために雇うニューラルアシスタントであり、汎用チャットボットではありません。
典型的な役割: マーケター、セールス、サポート、予約。典型的なチャネル: Telegram、WhatsApp、Avito、Instagram、サイトウィジェット。
各従業員には、カード、メモリ、チャット、既製の返信、アンケート、タスク、そして多くの場合Telegramボットがあります。人々はチャネルで彼らと話します。あなた(またはあなたのコーディングエージェント)はここから彼らを実行します。
製品の詳細: ai.knopka.click。
Related MCP server: MCP AgentChat
ロードマップ
現在利用可能
Telegramからのログイン(URLにトークンなし)、親
awp_/ 子awm_キーアンケート(DSL、回答、統計、共有)
タスク
ワーカーカード、メモリ、チャット、既製の返信、送信とブロードキャスト
Telegram: ステータス、コマンドメニュー、プロセス再起動(
telegram_*でのチャット送信なし)Booking CRM
2つのウォレット(アカウントUSD + グループTokenTime); 給与と1回限りのttはquote→confirm経由
次回
ファイナンスモジュール(
fin_op)— v1ではスタブ子キーの発行は後でグループTokenTimeを差し引く(現在は無料)
製品の他のチャネルも、管理画面に登場次第、同じMCPを通じて
クイックスタート
chmod +x install.sh
./install.sh@aiworkersbotからキーを取得します。MCPはこのURLを共有できます。リンクにはトークンはありません:
https://t.me/aiworkersbot?start=mcp
ミニアプリはトークンを1回表示します。コピーしてから:
aiworkers-mcp loginプロンプトでトークンを貼り付けます。~/.config/aiworkers/credentials.json(chmod 600)に書き込まれます。エージェントを再起動します。**aiworkers_whoami**を呼び出すように依頼します。
ツールaiworkers_login_linkは、既存のキーがなくても同じURLを返します。
レガシーフォームのキーはAIWORKERS_API_KEYとして引き続き機能します。
インストールせずにuvx:
uvx --from git+https://github.com/dimaneuron/aiworkers-mcp.git aiworkers-mcp環境変数
変数 | 意味 |
| 親 |
| ワーカー用の子 |
| デフォルト |
| デフォルト |
| デフォルトのTelegram |
| カンマ区切りリスト。デフォルト |
|
|
mcp.jsonにシークレットを置くよりもaiworkers-mcp loginを推奨します。モジュールごとの子トークンは他のモジュールを呼び出せません。
フォールバック(古い名前も引き続き機能): SURVEY_MCP_API_KEY、TASKS_MCP_API_KEY、TASKS_GROUP_ID、BOOKING_INTERNAL_SECRET。
ツール
常時利用可能:
aiworkers_whoami— このキーが何を見られるか(最初にこれを呼び出す)aiworkers_login_link— Telegram URL、リンクにトークンなしaiworkers_skill— エージェント SKILL.mdaiworkers_skill_update—~/.cursor/skills/aiworkers/SKILL.mdを書き込み/更新aiworkers_token_mint— 親awp_が1つのモジュール+グループ用に子awm_を発行(1回表示;save=trueでcredentials.jsonに書き込み)。現在は無料。後でグループTokenTime。
surveys: survey_agent_skill、survey_get_dsl_rules、survey_validate_dsl、survey_create、survey_agent_list_forms、survey_agent_get、survey_agent_update、survey_agent_responses、survey_agent_stats、survey_agent_settings_get、survey_agent_settings_save、survey_agent_scenarios_get、survey_agent_scenarios_save、survey_agent_archive、survey_agent_delete、survey_agent_share。リソース: survey://dsl/spec。
tasks: tasks_list、tasks_count、tasks_get、tasks_create、tasks_update、tasks_batch_update、tasks_complete、tasks_cancel。
workers(読み取り+書き込み、ログなし): workers_list、workers_get、workers_balance、workers_topup_link、給与/tt quote→confirm、workers_partner、workers_update(tt以外)、メモリ/チャット/readyreply、workers_chat_send(既知のチャットのみ、bot/embed/topic)、workers_broadcast_quote / workers_broadcast_confirm。お金とブロードキャスト: quoteしてからconfirm=true。
telegram(チャット送信なし): telegram_status、telegram_commands_get、telegram_commands_save、telegram_restart。ワーカープロセスを再起動(aibot-<username>、/telegram_botと同じ)。ボットごとに60秒のクールダウン; 429 retry_after — 連打しないでください。そのためにworkers_updateを使用しないでください。個人/ブロードキャストはworkersの下にあります。
crm(Booking CRM): crm_context、crm_process。
finance — v1にはありません。
エージェント設定
同じmcpServers.aiworkersブロックを貼り付けます。設定ファイルのパスのみ変更します。
共有JSON:
{
"mcpServers": {
"aiworkers": {
"command": "aiworkers-mcp",
"env": {
"AIWORKERS_API_BASE": "https://ai.knopka.click",
"AIWORKERS_API_KEY": "PASTE_awp_OR_awm_TOKEN"
}
}
}
}エージェント | 設定ファイル | 例 |
Cursor |
| |
Claude Desktop |
| |
Claude Code |
| |
VS Code Copilot |
| |
Windsurf |
| |
OpenClaw |
| |
Codex CLI |
| |
Gemini CLI |
| |
Cline |
| |
Continue |
|
編集後、エージェントを再起動します。
uvxバリアント(グローバルインストールなし): examples/openclaw-uvx.jsonを参照。
互換性
古いCLIも引き続き機能します:
aiworkers-survey-mcp—AIWORKERS_MODULES=surveysと同じaiworkers-tasks-mcp—AIWORKERS_MODULES=tasksと同じ
傘パッケージがPYTHONPATH上にある場合、これらはここに委任します。それ以外の場合は、以前と同様にスタンドアロンのFastMCPを実行します。
プライバシー
このリポジトリはクライアントです。.env、トークン、または資格情報をここに置かないでください。
日本語
Cursor、Claude、OpenClawがニューラル従業員を管理するためのMCP。
製品: ai.knopka.click · MCPランディング: ai.knopka.click/mcp
エージェントの場合: 上記のクイックスタートに従ってください。人間がaiworkers-mcp loginを実行します。トークンをでっち上げないでください。12語のシードをチャットに取り込まないでください。
ニューラル従業員とは
これらは役割に特化したニューラルアシスタントであり、「単なるチャットボット」ではありません。
役割: マーケター、セールス、サポート、予約。チャネル: Telegram、WhatsApp、Avito、Instagram、サイトウィジェット。
各従業員には、カード、メモリ、チャット、既製の返信、アンケート、タスク、そして多くの場合独自のTelegramボットがあります。クライアントはチャネルで彼らにメッセージを送ります。あなた(またはCursorのエージェント)はここから彼らを管理します。
詳細はai.knopka.clickをご覧ください。
ロードマップ
すでに動作中
Telegramからのログイン(リンクにトークンなし)、親
awp_/ 子awm_キーアンケート(DSL、回答、統計、共有)
タスク
カード、メモリ、チャット、既製の返信、送信とブロードキャスト
Telegram: ステータス、コマンドメニュー、プロセス再起動(
telegram_*経由の送信なし)Booking CRM
2つのウォレット(アカウントUSD + グループTokenTime); 給与と1回限りのtt購入 — quote → confirm
今後
ファイナンスモジュール(
fin_op)— v1ではスタブ子キーの発行は後でグループTokenTimeを差し引く(現在は無料)
製品の他のチャネルも、管理画面に登場次第、同じMCPを通じて
Available Tools
59 toolsaiworkers_login_linkA
Share a Telegram URL to get a one-time MCP token. The link has no secret. After the Mini App shows the token once, run aiworkers-mcp login and paste it. Works without an existing key.
Inputs: no named parameters. Returns: result
aiworkers_skillA
Return the AIWorkers MCP SKILL.md (how to log in and which tools to call). No existing key required.
Inputs: no named parameters. Returns: result
aiworkers_skill_updateA
Write/refresh SKILL.md into ~/.cursor/skills/aiworkers (and project .cursor/skills if present). Call this to pick up the latest skill after a deploy. No existing key required.
Inputs: no named parameters. Returns: result
aiworkers_token_mintA
Mint a child awm_ token for one module + one group. Parent awp_ only. Token is shown once. save=true (default) writes it to credentials.json so this MCP can call that module without Mini App. Free for now; later will debit group TokenTime.
Inputs: module (required), save, group_id. Returns: result
aiworkers_whoamiA
Show what this API key can see: groups, modules, endpoint map. Call this first. If there is no key, returns the login URL.
Inputs: no named parameters. Returns: result
crm_contextC
Resolve Booking CRM context: linked Telegram group and topic keys.
Inputs: group_id, username. Returns: result
crm_processC
Create/update/cancel a Booking CRM event. payload_json: {action, event, ...}.
Inputs: payload_json (required), group_id. Returns: result
survey_agent_archiveA
Archive (hide from list) or restore a survey. Does not delete answers.
Inputs: survey_id (required), archived. Returns: result
survey_agent_deleteA
Permanently delete a survey, DSL file, and answers. Requires confirm=true.
Inputs: survey_id (required), confirm. Returns: result
survey_agent_getB
Get survey DSL and metadata. survey_id may be the full id, public slug, or form URL.
Inputs: survey_id (required). Returns: result
survey_agent_list_formsA
List surveys for this API token (scoped by group_id). Archived hidden unless include_archived.
Inputs: include_archived. Returns: result
survey_agent_responsesC
Fetch respondent answers for a survey.
Inputs: survey_id (required). Returns: result
survey_agent_scenarios_getC
Get post-submit automation scenarios.
Inputs: survey_id (required). Returns: result
survey_agent_scenarios_saveC
Save post-submit scenarios (JSON array or {"scenarios": [...]}).
Inputs: survey_id (required), scenarios_json (required). Returns: result
survey_agent_settings_getC
Read survey settings (view mode, etc.).
Inputs: survey_id (required). Returns: result
survey_agent_settings_saveC
Save survey settings. settings_json is an object or {"settings": {...}}.
Inputs: survey_id (required), settings_json (required). Returns: result
survey_agent_skillD
Agent skill: auth, endpoints, group-bound token.
Inputs: format. Returns: result
survey_agent_statsC
Funnel stats for a survey.
Inputs: survey_id (required). Returns: result
survey_agent_updateC
Update survey DSL (POST; nginx often 405s PUT).
Inputs: dsl (required), survey_id (required). Returns: result
survey_createC
Create a survey from DSL. Child token: group_id must match the key or be omitted. Mismatch → 403.
Inputs: dsl (required), group_id, creator_id. Returns: result
survey_get_dsl_rulesB
Fetch current Survey DSL parsing rules from the server.
Inputs: format. Returns: result
survey_validate_dslA
Validate Survey DSL without saving.
Inputs: dsl (required). Returns: result
tasks_batch_updateC
Batch update: updates_json is JSON array of {id, ...fields}.
Inputs: updates_json (required), group_id. Returns: result
tasks_cancelC
Cancel task (releases calendar hold).
Inputs: task_id (required), group_id. Returns: result
tasks_completeB
Mark task done (releases calendar hold).
Inputs: task_id (required), group_id. Returns: result
tasks_countC
Count tasks with the same filters as tasks_list.
Inputs: q, source, status, to_time, +2 more. Returns: result
tasks_createB
Create a manual task (optional Telegram card + calendar hold).
Inputs: title (required), contact, end_date, group_id, +3 more. Returns: result
tasks_getC
Get one task by id.
Inputs: task_id (required), group_id. Returns: result
tasks_listC
List tasks for a Telegram group (manual + booking).
Inputs: q, limit, offset, source, +4 more. Returns: result
tasks_updateC
Update task fields. patch_json: JSON object with title/description/status/dates.
Inputs: task_id (required), group_id, patch_json. Returns: result
telegram_commands_getA
Read bot command menu (segments + translations). Does not send messages.
Inputs: group_id. Returns: result
telegram_commands_saveC
Save bot commands. JSON: builtin/custom/segments/translations. Syncs Bot API menu, no chats.
Inputs: commands_json (required), group_id. Returns: result
telegram_restartA
Restart this group's Telegram worker process (pm2 aibot-). Same as /telegram_bot «Перезапустить скрипт». Rate-limited (60s per bot); on 429 wait retry_after, do not loop. Use when the user asks to restart the bot — not workers_update. Does not send messages.
Inputs: group_id. Returns: result
telegram_statusC
Bot connection status (username/id, no token). Does not send messages.
Inputs: group_id. Returns: result
workers_balanceB
Two layers: account.usd (shared wallet) and group.tt (TokenTime). Empty group_id uses credentials / AIWORKERS_GROUP_ID, else «нужен group_id». Does not charge.
Inputs: group_id. Returns: result
workers_broadcast_confirmA
Start the quoted bot-user blast. confirm must be true. Quote lives ~5 min; reuse 409. Status goes to the mailing topic.
Inputs: quote_id (required), confirm, group_id. Returns: result
workers_broadcast_quoteA
Preview a one-shot DM blast of a ready reply to everyone who already wrote this worker bot. Does not send until workers_broadcast_confirm(quote_id, confirm=true). Not widget, not folders, not arbitrary ids.
Inputs: rr_id (required), group_id. Returns: result
workers_chat_sendA
Send one message to a known chat from workers_chats_list. channel=auto|bot|embed|topic (auto: bot DM, or embed outbox for widget users). Mirrors into the user's forum topic. Need text and/or rr_id. Does not send to arbitrary Telegram ids. Rate-limited.
Inputs: user_id (required), text, rr_id, channel, +1 more. Returns: result
workers_chats_getB
Get one user chat card (no message logs).
Inputs: user_id (required), group_id. Returns: result
workers_chats_listC
List user chats (no message logs).
Inputs: limit, group_id. Returns: result
workers_getA
Read the worker card (no bot tokens). For money prefer workers_balance.
Inputs: group_id. Returns: result
workers_listA
List workers this key can access. Each row has group tt/usd/stars. Root account is the shared USD wallet once. For one group use workers_balance.
Inputs: no named parameters. Returns: result
workers_memory_addC
Add a memory entry to a topic (topic_*).
Inputs: content (required), topic, group_id. Returns: result
workers_memory_create_topicC
Create a new memory forum topic.
Inputs: name, group_id. Returns: result
workers_memory_deleteC
Delete a memory entry by message_id.
Inputs: message_id (required), topic, group_id. Returns: result
workers_memory_editC
Edit a memory entry by message_id.
Inputs: content (required), message_id (required), topic, group_id. Returns: result
workers_memory_getC
Read memory topics and entries. Optional topic=topic_.
Inputs: topic, group_id. Returns: result
workers_partnerA
Platform partner terms, catalog/builder/community URLs, ref_link. rates is a constants dict — do not invent percents if empty. Not the worker-bot /ref product.
Inputs: no named parameters. Returns: result
workers_readyreply_create_topicC
Create a Telegram topic for ready replies.
Inputs: name, group_id. Returns: result
workers_readyreply_deleteC
Delete a ready reply by id.
Inputs: rr_id (required), group_id. Returns: result
workers_readyreply_listC
List ready replies, or one item if rr_id is set.
Inputs: rr_id, group_id. Returns: result
workers_readyreply_upsertC
Create or update a ready reply. Posts the donor into the native ready-reply Telegram topic (P{message_id} + customization button). item_json: text/triggers/caption/buttons/topic_name.
Inputs: item_json (required), rr_id, group_id. Returns: result
workers_salary_confirmA
Charge a salary quote. confirm must be true. Quote lives ~5 min; reuse is 409. Cannot decrease contribution (write @dimaneuron).
Inputs: quote_id (required), confirm, group_id. Returns: result
workers_salary_quoteB
Preview raising YOUR contribution by whole USD. Debits account, adds add_usd*3600 tt, raises solary. Does not charge until workers_salary_confirm(quote_id, confirm=true). Other admins can raise their own share.
Inputs: add_usd (required), group_id. Returns: result
workers_topup_linkA
URL to top up the ACCOUNT wallet in @aiworkersbot (users.balance). Does not credit group tt. No tt_credit. If amount_usd omitted: ask_amount=true and start=addBalance. If set: start=addBalance_10 (integer USD); bot shows Change amount. Dot in start payload is invalid.
Inputs: group_id, amount_usd. Returns: result
workers_tt_buy_confirmA
Charge a one-time tt quote. confirm must be true. Quote lives ~5 min; reuse is 409. solary unchanged.
Inputs: quote_id (required), confirm, group_id. Returns: result
workers_tt_buy_quoteA
Preview one-time tt buy at 10x subscription ($10 → 3600 tt). Does not change solary. Pass amount_usd or tt. Does not charge until workers_tt_buy_confirm.
Inputs: tt, group_id, amount_usd. Returns: result
workers_updateB
Update worker fields: status, lang, paid_until, translate_langs. Never write tt here — use workers_salary_quote or workers_tt_buy_quote.
Inputs: group_id, patch_json. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 59 tools
Each tool targets a specific resource and action, with detailed descriptions that clearly distinguish purposes. Even within similar domains (e.g., multiple quote/confirm pairs), the resource (salary, tt, broadcast) is explicit, preventing confusion.
The naming follows a predictable pattern: each functional area uses a consistent prefix (e.g., workers_, survey_, tasks_) and verb_noun or noun_verb structure within that area. There is no mixing of conventions across the server.
With 59 tools, the count is excessive for a single MCP server. While the domain is broad, it exceeds the recommended range and would likely overwhelm agents. Splitting into sub-servers (e.g., surveys, workers, tasks) would improve usability.
The tool surface covers nearly all aspects of the AI Workers platform: account, workers, surveys, tasks, memory, chats, broadcasts, ready replies, Telegram commands, and CRM. Minor gaps exist, such as no tool for listing chat message history or editing worker groups, but core workflows are well-supported.
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
AI agent platform: manage leads, conversations, bots, calendar and CRM via MCP.
MCP server for AI agents: posts, messages and comments on WhatsApp, Instagram, TikTok and Facebook.
Hosted Telegram MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server for communication service connectors that currently provides multi-account Telegram integration with granular tool access and security controls. It allows AI models to manage messages, chats, and media across various accounts through a flexible, extensible routing architecture.1-
- AlicenseNot gradedqualityDmaintenanceAn MCP server enabling AI agents to interact with users via Telegram, supporting message and image sending, inline quick replies, and waiting for user responses.5 npmMIT
- AlicenseNot gradedqualityBmaintenanceMCP server exposing WhatsApp Cloud API operations as tools for AI agents like Claude Code, Cursor, and Codex.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents hands to make phone calls, send messages, and handle CRM/task workflows. It runs with a simulated provider for zero-cost testing and can switch to real providers like Twilio and ElevenLabs.MIT