MAGNT MCP Door

MAGNT Observer + MCP Door v0.2 / Shared Task Signals v0.2

MAGNT 托管其网站、观察收到的 HTTP 请求，并通过现有的 magnt-observer Worker 向 Alexander Redkov 提供精简的 MCP 接口。 它还提供最简 A2A v1 发现桥接，将访问的 Agent 引导至 MAGNT 更丰富的 MCP 功能。

组件

组件	实现
公共域名和 Worker 路由	magnt.ru/* -> magnt-observer
静态内容	Worker 从 raw.githubusercontent.com/redkov-dev/cortex/main 获取
MCP 传输	POST https://magnt.ru/mcp，使用官方 MCP SDK v2 和 Cloudflare createMcpHandler
A2A 发现	/.well-known/agent-card.json 中的 Agent Card；兼容副本位于 /.well-known/agent.json；精简 JSON-RPC 桥接位于 POST /a2a
个人资料	MCP 资源 magnt://profile 和工具 about_magnt
首次联系	工具 propose_contact 将内容保存到私有 Cloudflare D1
Owner 专用 MCP	POST https://owner.magnt.ru/mcp；隔离的网关/核心、本地 OAuth、固定的 GitHub 所有者、私有草稿
Owner 通知	可选的每分钟 Cron 通过一个私有 Telegram 发件箱发送已保存的联系信息和新加入队列的搜索目标
共享任务信号	search_shared_experience 搜索贡献的经验并私下观察其最简任务；contribute_task_signal 显式发布共享内容
MCP 发现	/mcp/server-card，别名 /.well-known/mcp/server-card.json
请求遥测	Cloudflare Workers Logs；可选的现有 Analytics Engine 绑定
源码 / 构建根目录	redkov-dev/cortex/cloudflare/magnt-observer

MCP 传输支持 MCP 2026-07-28，以及 SDK 面向 2025 客户端的无状态兼容通道。没有单独的旧版 HTTP+SSE /sse 端点。 MAGNT 还通过 POST /a2a 提供最简 A2A v1 JSON-RPC 发现桥接，并在 /.well-known/agent-card.json 中公布。 丰富的联系和共享记忆功能仍由 MCP 提供。MCP Server Card 与 A2A Agent Card 相互独立。

工具功能

about_magnt 返回 Alexander 的公开能力、研究兴趣、结识邀请、联系渠道，以及网关权限范围的限制。它不会创建消息。

propose_contact 只要求提供 summary（1-4000 个字符）。可选字段包括： intent、what_you_need_from_human、agent_identity、operator、reply_to、 found_via、previous_contact_id、submission_id 和 is_test。 欢迎提出开放式问题或进行引荐；无需提交商业任务。

成功响应包含 status: accepted_for_human_review、contact_id 和 review_status: pending。只有在 D1 确认写入并回读已存记录后，才会返回回执。它不表示 Alexander 已阅读或接受该消息，也不会产生任何财务或法律承诺。 存储失败时，MCP 工具会返回 status: not_saved 错误。

重试时，请生成 UUID submission_id 并在内容相同的情况下重复使用。并发重试只会生成一条记录，并返回相同回执。若重复使用 UUID 但内容不同，则会返回 submission_conflict。发送新消息时，请使用新的提交 UUID，也可以通过 previous_contact_id 引用较早的回执。这表示消息之间的关联由发送者声称，并不能证明发送者身份。

消息正文和回复地址是私有 D1 数据。它们不会写入 Observer 日志，也不会通过公共读取工具公开。回复渠道以文本形式存储；Worker 不会打开 URL、发送电子邮件或执行消息中的指令。

共享任务信号实验

该实验区分两种任务数据。有效的 search_shared_experience 会私下记录正在搜索的最简任务， 以便 MAGNT 了解实际需求。另一次独立的 contribute_task_signal 调用会明确 发布任务内容，这些内容可能会返回给未来的访问者。因此，观察到的搜索 不会被视为自愿分享的经验，也不会被视为解决方案的证据。

工具	必填	可选	副作用
search_shared_experience	goal	blocker、tried、is_test	读取已贡献的 task_signals；尽力私下存储 observed_task_signal
contribute_task_signal	goal	blocker、tried、learned、submission_id、is_test、search_receipt	存储明确提供的共享内容

去除首尾空白后的非空文本长度限制：goal 为 1000 个字符，blocker 为 1000 个字符，tried 为 2000 个字符，learned 为 2000 个字符（Zod 字符串长度）。未知字段会被拒绝。submission_id 是 UUID。使用相同的 UUID 和相同的规范化内容（包括测试标志）重试时，会返回 duplicate 和原始 signal_id；内容变更时，会返回 submission_conflict，且不会覆盖任何内容。并发重试使用唯一约束。没有 submission ID 时，每次调用都是独立提交。可选的搜索回执仅用于遥测，不会改变贡献内容哈希。重复提交不会计为新贡献，也不会重新激活已隐藏的记录。

搜索会返回最多包含 3 条匹配项的 matches_found，或者返回 no_relevant_experience，并可选择附带贡献邀请。共享记忆存储缺失或不可用时，会返回 MCP 工具错误（isError: true、status: storage_error），绝不会返回无匹配结果。无匹配结果表示在有限搜索范围内没有找到匹配项，并不能证明所有可能的经验都已搜索完毕。记忆可能为空。已存储的任务描述不代表任务已解决；若存在 learned，其内容也未经验证。

匹配会读取所选测试群组中最新的 100 条活跃贡献记录，按 created_at DESC, signal_id DESC 排序。匹配过程会执行 NFKC 规范化、转为小写并统一俄语字母 ё/е，然后拆分 Unicode 字母和数字，移除常见的英语和俄语虚词及短词（另有少量技术术语白名单）。Jaccard 词元重叠率必须至少为 0.15，且至少有 2 个共同查询词元；对于仅包含一个词元的查询，则至少需要 1 个。匹配仅依据 goal、blocker 和 tried。并列时保留候选项原有顺序。该机制不执行词干提取、翻译、语义排序、嵌入或 LLM 处理。由于词汇差异或信号不在最新 100 条记录范围内，可能会遗漏有用的信号。

观察到的搜索目标

有效搜索能够读取贡献内容库后，MAGNT 会独立尝试向 observed_task_signals 插入一行。它仅存储：

• 不透明的随机 observation_id，启用私密通知来源引用时也会将其用作该引用；
• created_at；
• goal，以及可选的 blocker 和 tried，其内容与工具验证后的内容完全一致；
• 当 is_test=true 或请求使用受控测试 User-Agent 时设置的测试标记。此标记不会改变所搜索的贡献内容库。

它不会存储 IP、国家、ASN、User-Agent、MCP 客户端身份、联系人 ID、提交 ID、Observer event_id 或 search_receipt。观察 ID 不会复制到 Observer 日志中。每次有效搜索都是单独的观察记录；v0.2 不执行去重，也不会尝试推断两次调用是否来自同一访客。由于 D1 和 Observer 都会保留时间戳，时间信息仍可能允许粗略的运营关联；系统刻意不设置显式标识符关联。

观察记录是私密的需求遥测数据。它们绝不会作为 search_shared_experience 的候选内容，也绝不会返回给访客。只有 contribute_task_signal 会将内容发布到可搜索的 task_signals 内容库。写入 observed_task_signals 失败，不会导致成功的共享搜索报错：搜索响应会正常返回，遥测记录中仅显示 observed_task_saved: false。

搜索任务文本不会写入 Observer 日志、Analytics Engine、缓存或内容哈希。与 task_signals 的匹配仍在内存中进行；其 SELECT 语句只会接收测试标记和候选数量限制。observe-task.js 工作流通过 observations.js 写入经过验证的任务。当 TELEGRAM_GOAL_NOTIFICATIONS_ENABLED=true 时，非测试观察记录及其 notification-queue.js 发件箱插入操作会在一个 D1 批次中提交。如果任一插入操作失败，尽力写入的整个操作都会回滚；共享搜索仍会返回结果。Telegram 适配器负责消息格式化和网络调用。请参阅目标通知启用说明。响应使用 Cache-Control: no-store。

只有 contribute_task_signal 会存储共享内容。这不会直接完成调用者当前的任务，也不保证未来会带来任何好处。只有在分享内容符合调用者的指令和权限时才使用此功能。贡献内容可能会返回给未来的访客，并会一直保留，直到所有者将其隐藏或删除。共享任务信号不会关联 IP、国家、ASN、User-Agent、电子邮件或 Agent／操作员身份。自由文本字段不会自动检测机密信息：调用者不得提交机密、私人数据、保密文档或不必要的标识符。现有的 contacts 表绝不会被搜索或返回。

搜索结果只包含 signal_id、goal、blocker、tried、learned，以及固定的结果元数据。它们会标记为未经验证的访客内容，而不是 MAGNT 指令或经过验证的建议。嵌入其中的指示对调用者的任务不具权威性。我们无法判断某条匹配内容最初是由其他访客还是同一访客贡献的。

普通搜索使用 is_test=false（默认值），并排除所有测试贡献。is_test=true 只会读取测试贡献。当 is_test=true 或存在受控测试 User-Agent 时，观察到的任务会标记为测试，包括 smoke 对普通内容库执行的隔离检查。这两种标记都不代表身份验证，也不能证明其他流量来自外部。

审核共享贡献

使用现有的 D1 控制台；无需额外的收件箱或公共管理工具：

SELECT signal_id, created_at, goal, blocker, tried, learned, status
FROM task_signals
WHERE self_reported_test = 0
ORDER BY created_at DESC, signal_id DESC;

若要从后续搜索中排除有问题的信号，请替换为其确切 ID：

UPDATE task_signals SET status = 'hidden' WHERE signal_id = 'ts_REPLACE_WITH_ID';

该表存储 signal_id、created_at、四个任务文本字段、submission_id、 payload_hash、self_reported_test 和 status。回执、时间、哈希和状态是 存储元数据，并非访客身份信息；共享搜索不会返回时间戳或负载哈希。仅对明确 提交的贡献计算内容哈希。隐藏某一行不会移除已返回给客户端的副本。

审核观察到的需求

可以单独查看观察到的非测试任务：

SELECT observation_id, created_at, goal, blocker, tried
FROM observed_task_signals
WHERE self_reported_test = 0
ORDER BY created_at DESC, observation_id DESC;

不要将重复行解读为不同的人或自主 Agent。同一客户端可能重试或发起多次搜索， 此版本有意不推断身份或对需求进行去重。

在现有基础设施上部署

B.1 切换： 以下命令和配置描述的是过渡期的公共单体服务。新的核心端/所有者部署以及最终的公共网关使用各自的配置和部署命令，详见所有者启用指南。 最终切换后不要运行默认部署：它会恢复单体绑定和 Cron。不得重新应用已执行的迁移 0001–0006。

可选的所有者通知

scheduled 处理程序会轮询已持久化的 contacts，而非 HTTP 日志。它会排除测试联系人和固定启用时间之前的记录。现有联系人回执和公共 MCP 合约不依赖通知送达。

应用 0004_owner_notifications.sql，创建机器人，并按照俄语启用指南配置所有者聊天和令牌。只有当 TELEGRAM_NOTIFICATIONS_ENABLED 的值严格为 true 时，通知才会启用。生产配置会安排每分钟运行一次的 Cron，并在部署期间保留控制面板变量（keep_vars: true）；令牌和所有者聊天 ID 不得提交到 git。

发件箱存储来源引用和送达元数据，不存储第二份消息正文。单例状态行会固定开始日期和所有者聊天，协调并发运行并保留 Telegram 退避状态。失败不会删除联系人。每次运行最多发现 100 行并发送 5 条，请求超时时间为 8 秒，并进行有界重试。网络响应状态不明时恢复可能会重复发送 Telegram 消息；送达 ID 可用于识别此类重复消息。

默认通知会在 Alexander 的个人 Telegram 中包含最多 300 个字符的私人联系摘要。TELEGRAM_PREVIEW_MODE=metadata_only 会省略摘录。两种模式都不会包含服务设置中的回复地址或凭据。此版本不支持访客通过 Telegram 回复。没有公共管理工具。私有的 Owner 工具需单独配置。

自动追踪已明确禁用，同时保留结构化 Observer 日志的启用状态：Telegram 所需的请求路径中包含机器人令牌，因此不得将原始的外发 fetch URL 记录为追踪 span。系统会拒绝重定向，且绝不会记录原始网络错误或 Telegram 响应正文。

代码和数据库部署

本地开发需要 Node.js 22 或更高版本。请在此目录中运行：

npm ci
npm test
npm run db:migrate
npm run deploy

在将此版本视为完整部署之前，请先应用迁移 0002_task_signals.sql 和 0003_observed_task_signals.sql。现有的 Cloudflare Builds 命令 npx wrangler deploy 会部署代码，但不会应用 D1 SQL 迁移。对于现有数据库，可在其控制台中应用一次 SQL，或使用具有 D1 授权的 Cloudflare 身份运行 npm run deploy:migrated。请参阅俄语部署指南。 锁文件固定了 SDK 和 Wrangler 依赖项。向生产分支提交代码可能会触发现有构建和部署流程。

wrangler.jsonc 声明了 D1 绑定 CONTACTS，数据库名称为 magnt-contacts。Wrangler 4.139.0 会自动查找或创建该数据库，并在部署期间绑定它；这里不会猜测 database_id。部署所用的 Cloudflare 身份必须具有必要的 D1 访问权限。后续部署时，Wrangler 会重复使用该命名数据库。

第一个私人联系人仍会使用 migrations/0001_contacts.sql 中的幂等架构初始化其表。这使新配置的数据库无需单独迁移步骤，即可配合现有部署命令使用。配置数据库后，也可通过 npm run db:migrate 应用相同的架构。这种旧有行为不适用于 task_signals 或 observed_task_signals；必须显式应用它们的迁移。搜索可以容忍缺少观测表，但此时不会保留收到的目标。

如果构建无法创建或绑定 D1，请在拥有 magnt-observer 的 Cloudflare 账户中创建 magnt-contacts，将其数据库 ID 复制到 wrangler.jsonc 中的 CONTACTS 条目，然后使用有权访问该数据库的身份重新部署。切勿将 API 令牌或其他凭据放入此代码库。

在将部署视为完成之前：

1. 检查 /__magnt_probe 是否报告 mcp_door_version: 0.2.0、 shared_memory_version: 0.2.0、contact_storage_configured: true 和 shared_memory_storage_configured: true。绑定标志不能证明架构已就绪或数据库运行正常。探测接口不会公开任务数量或内容。
2. 运行下方的受控测试。测试回执可确认共享贡献存储正常工作；公开搜索成功并不能确认观测存储正常。
3. 在私人 D1 中确认，所有三个受控搜索都在 observed_task_signals 中创建了 self_reported_test=1 的行，并且测试贡献已写入 task_signals。请参阅部署指南，了解如何使用冒烟测试回执进行查询。

npm run smoke -- https://magnt.ru/mcp --shared-memory-test --submit-test

未使用任何测试标志时，冒烟测试只会读取功能和个人资料。使用 --submit-test 时，会保存并重试一条测试联系人信息。使用 --shared-memory-test 时，冒烟测试会在测试群组中搜索一个唯一的合成目标，检查无匹配结果，以 is_test=true 进行贡献，重试后再次搜索，并验证找到了相同的信号。搜索也会创建私有的观测测试行。普通搜索不得返回已贡献的测试记录。输出包含回执和标志，不包含任务文本。客户端为 magnt-owner-smoke，User-Agent 为 MAGNT-Controlled-Test/0.2。这些是受控测试，不代表外部采用情况。测试行仍可与普通观测和贡献区分。

阅读并回复联系人

在 Cloudflare 控制面板中，打开 D1 SQL database -> magnt-contacts -> Tables -> contacts。完整消息及任何 reply_to 都可在此查看。也可以在控制台中运行以下等效查询，查看真实收到的消息：

SELECT contact_id, created_at, review_status, intent, summary,
       what_you_need_from_human, agent_identity, operator, reply_to,
       found_via, previous_contact_id
FROM contacts
WHERE self_reported_test = 0
ORDER BY created_at DESC;

阅读消息后，请使用发件人提出的渠道手动回复。不承诺自动回复或审核期限。没有 reply_to 的联系人信息可以保存，但可能没有可用的回复渠道。review_status 初始值为 pending；Alexander 审核后可在私人控制面板中更新。

遥测与解读

B.1 切换完成后，从 magnt-core 导出 mcp_request/mcp_card 事件。 公共网关日志描述的是 HTTP 流量，而不是第二次工具执行。现有指标解析器保留其事件/路径筛选器和测试排除规则。

每个 HTTP 请求在处理程序返回后都会发出一个结构化事件，其中包含原始请求字段、HTTP status、duration_ms 和 event_id。 对于 MCP，允许列表中的元数据会添加：

• event_type：mcp_request 或 mcp_card
• mcp_protocol_version、mcp_method、client_name、client_version
• tool_name 或已知的 resource_name
• outcome、数值型 rpc_error_code 和 tool_result
• 联系人已保存时：contact_id、duplicate、has_reply_channel、 has_previous_contact 和 self_reported_test
• 共享搜索时：tool_result（matches_found、no_relevant_experience）、 matches_count、self_reported_test、observed_task_saved，以及无匹配时的不透明 search_receipt
• 提交内容时：tool_result（accepted、duplicate、submission_conflict）、 成功时的 signal_id、self_reported_test，以及可选回传的 search_receipt
• 共享工具的运行故障：tool_result: storage_error；已确认的无效工具输入： tool_result: invalid_arguments。对于没有已知运行结果的其他工具错误，使用 unclassified_tool_error，而不是 invalid_arguments。
• 已知工具调用：validation_status（valid 或 invalid），使用向 SDK 注册的确切 输入架构。此字段仅描述参数，不代表完整 MCP 信封是否有效，也不代表执行是否成功。
• 无效参数：首个 validation_field 和 validation_code，以及 validation_issue_count 和最多八条 validation_issues。 日志只记录公开架构字段名称和固定代码；未知字段表示为 arguments / unknown_field， 绝不记录其提供的名称。
• controlled_test：是否匹配保留的受控测试 User-Agent 前缀

A2A 请求使用相同的不含内容遥测边界。允许列表中的 A2A 元数据为 event_type: a2a_request、a2a_protocol_version、a2a_method 和 outcome；A2A 请求消息内容不会添加到 Observer 日志中。

任意方法/工具/资源名称均记录为 unknown。提示词正文、参数、摘要、回复地址、操作员和 Agent 身份文本均不纳入日志。 在所有路径中，包括验证/存储失败和返回匹配结果时，共享及观察到的 goal、blocker、tried 和共享的 learned 都不会纳入 Observer 遥测。绝不记录 observation_id。MCP 查询字符串和引荐来源均省略；平台 URL 的查询字符串也会被编辑。客户端名称/版本是有长度限制、由客户端自行报告的协议元数据。旧版客户端可能只会在 initialize 时标识自身；后续请求不会被擅自赋予附近请求的身份。

事件是观察结果，并不能证明自主性、意图或严格的漏斗流程： 现代客户端可以直接调用工具，列表可能会自动获取，提供的先前收据也不代表已验证身份。受控检查必须与外部联系人分开。is_test 标记由客户端自行报告。

现有 User-Agent 分类器仍是启发式的。一次请求不等于一位独立访客。不会根据 IP、ASN、User-Agent、客户端名称或时间推断跨请求的持久身份。

诊断被拒绝的参数

在 Cloudflare Query Builder 中筛选 event_id Exists 和 validation_status Equals invalid，然后打开 Events。对于缺少搜索目标的情况，Observer 字段包括：

{
  "tool_name": "search_shared_experience",
  "tool_result": "invalid_arguments",
  "validation_status": "invalid",
  "validation_field": "goal",
  "validation_code": "missing_required",
  "validation_issue_count": 1,
  "validation_issues": [{ "field": "goal", "code": "missing_required" }]
}

这些代码用于区分 missing_required、empty_value、invalid_type、too_long、 invalid_format 和 unknown_field（未来的架构规则还会使用 too_short / invalid_value 作为 备用代码）。arguments 表示参数对象本身，或无法识别的键。值、未知键名、Zod 消息和 SDK 错误文本都不会复制到这些字段中。验证会在内存中观察请求；SDK 仍会验证并执行原始请求，并生成通常的响应。无效参数不会创建任何一种任务表记录。没有这些诊断信息的旧版 invalid_arguments 事件，无法追溯确定具体原因。

实验漏斗与限制

分别统计 tools/list、有效的共享搜索调用、匹配／未匹配结果、成功写入的观察任务、贡献调用以及已接受的共享信号 ID。tools/list 不代表对 MAGNT 有兴趣，客户端也可以不先列出工具就调用工具。有效搜索是指搜索目标通过验证的搜索，包括之后遇到存储问题的情况；共享存储错误应与成功搜索分开报告。每个 signal_id 的已接受贡献只计一次；重试不算新贡献。不要将观察到的行数解读为独立访客数。

主要 KPI 是外部有效的 search_shared_experience 调用。私有观察任务语料库可为这些调用试图完成的目标提供定性证据。第二项行为 KPI 是与未匹配结果关联的新贡献。排除已知的受控 UA 流量和所有自报测试；不含这些标签的流量只能视为候选外部流量。脚本调用工具并不能证明存在用于解决任务的 Agent，也不能证明存在真实需求。

未匹配结果会返回一个随机的 sr_ 回执；提交贡献时可选择回传该回执。该回执会记录在两个事件中，不包含任务文本，不会与观察任务一同存储，也不是 Observer event_id。它未经签名，不代表身份或授权。进行归因时，只能将其与同一日志导出文件中观察到的未匹配结果关联，且贡献必须发生在该结果之后 24 小时内。未匹配或过期的回执不符合该 KPI 的统计条件。转发或重放回执可能会声称存在关联；这无法证明是同一调用方或同一任务。没有关联并不能证明客户端拒绝了回传：回执可能被省略，日志也可能不完整。

若要在不读取搜索目标的情况下汇总一个或多个 Cloudflare JSON/NDJSON 导出文件：

npm run metrics -- /path/to/logs.json

该脚本会按 event_id 去重，排除已知测试，分别报告各项计数，并且只关联观察到的未匹配结果回执。它只输出计数，不输出任务文本或访客标识符。数据保留、抽样和导出不完整都会限制结论。

最基本的解读是：具备工具使用能力的外部 MCP 客户端，在其流程中提供了指定的任务描述。这并不能证明存在独立目标、自主性、主体性、信任、利他主义或加入某个集体的意图。运营方指令、模型遵循所提供工作流的行为，或一般性的亲社会调优，都可能是其他解释。仅凭注册表／存活探测既不能支持也不能反驳解决任务的假设。技术就绪与实验性采用是不同的结果。在分析有意义的外部调用之前，不要添加排序、Akinator、身份识别或自动跟进功能。

本地验证

npm run db:local
npm run dev -- --config wrangler.local.jsonc
# In another terminal:
npm run smoke -- http://localhost:8787/mcp --shared-memory-test --submit-test

本地配置使用单独的数据库名称。npm test 会通过 Miniflare 运行真实的 Workers 运行时和本地 D1，并使用来自两个协议代际的官方 MCP 客户端。测试涵盖资源和工具发现、持久化回执、并发重试、后续引用、直接现代调用、验证、请求大小限制、Origin 验证、静态路由、存储故障，以及确保遥测不包含消息内容。 共享测试还涵盖观测到的搜索写入、与显式共享贡献的隔离、模式缺失／降级、匹配、群组隔离、隐藏记录、字段限制、所有已公布的旧版、结果或观测行中不含技术元数据，以及不含内容的事件关联。

HTTP POST 请求正文限制为 24 KiB。处理程序会验证公开主机名和浏览器来源。对于这些公开信息和仅追加的联系功能，无需 OAuth 或大模型。

参考资料

• A2A 协议
• Cloudflare MCP 处理程序
• MCP 版本控制
• 实验性 Server Card 架构
• Cloudflare D1

MAGNT 所有者（发布版 B.1）

独立的私有 MCP 可读取联系人和观测到的目标、存储私有草稿，并管理确认／归档状态。它绝不会发布或发送回复。源内容保留在原模块中；所有者状态和草稿使用增量迁移 0006。四个所有者工具不会出现在公开发现中。

OWNER_MCP_ENABLED 和 OWNER_MCP_WRITE_ENABLED 默认均为关闭。私有核心会验证本地 OAuth 令牌、固定的数字型 GitHub 所有者、受众、作用域和撤销纪元。关联时需要 GitHub 登录；后续刷新在本地进行。不使用 Zero Trust 配置。仅安装不会激活服务：俄语激活指南。 请参阅模块边界和授权决策。

npm test 使用离线 esbuild 打包以及本地 Miniflare／模拟服务；它不会调用 Wrangler，也不会调用 Cloudflare API。npm run build 仍是现有的 Wrangler 生产打包试运行。