MIND

@astramindapp/mcp-server

MIND MCP Server — 最完整的 AI 记忆层。44 个工具，384 项操作。

你的 AI Agent 会忘记会话之间的所有内容。MIND 可以解决这个问题。将任何兼容 MCP 的 Agent 连接到你的个人知识图谱，获得情绪智能、CRM、生活管理、全站可分配任务、社交功能、自我训练、自主洞察、仅限管理员使用的 Agent 指挥中心（含各 Agent 专属工单队列）、仅限管理员使用的 Featured Minds Portal（可从任何 MCP 客户端管理 m-i-n-d.ai 上的公开市场内容，包括模型、公开聊天提示词、温度、品牌字段，并将更改写入关联用户的个人资料），以及更多功能。

自描述。 每个连接的客户端都会在 MCP initialize 响应中收到完整的集成说明，并可通过 mind://integration-guide 资源查看完整指南。因此，无需额外说明，任何 Agent 都能了解 MIND 是什么、哪种集成方式适合其运行环境（MCP 服务 / OpenClaw 插件 / REST API）、如何进行身份验证，以及会话协议。

44 个工具

工具	操作数	功能说明
mind_query	1	在知识图谱中进行语义搜索（5 种搜索模式）
mind_remember	5	存储、搜索、获取、列出、删除 — document 和 entry（PRIVATE），feed_post（PUBLIC，仅限用户明确请求 — thought 保留为已弃用别名）
mind_folders	7	将文档整理到文件夹中 — 列出、创建、重命名、移动、删除、归档文档
mind_folder_routes	4	配置确定性的系统文件夹路由 — 自动将每种系统生成的文档（生活事项、CRM、聊天保存内容、任务、训练、交易者信号、云端导入内容）归档到指定文件夹
mind_folder_suggest	1	通过 routing_hint 和轻量级 LLM 选择器，询问 MIND 某段内容应归入哪个文件夹
mind_share	4	为一份 MIND 文档创建和管理分享链接 — 创建（默认）、列出、全部列出、撤销
mind_context	1	加载持久身份信息、偏好、规则、优先事项和近期活动
mind_life	16	目标、项目、任务 + 完整日历管理 + 效率统计
mind_focuses	5	Focus → Project 分类 — Life Projects 之上的顶层分组
mind_crm	7	联系人、销售管道、活动记录、互动历史
mind_tasks	9	全站任务 — 可分配、可完成的工作事项，可关联到项目、联系人或 Agent，并提供完成报告
mind_graph	3	图谱统计、诊断、实体标签
mind_admin	11	仅限管理员。 用户配置 + Featured Minds Portal：对公共市场内容进行完整的 CRUD 操作（get_full / update / update_owner_profile / reorder / delete）、套餐层级/额度管理
mind_sense	7	MINDsense 情绪智能 — 状态、信号、时间线、KG 权重、突发变化
mind_osint	7	操作 Ozzie — 自主 OSINT 分析师 — 针对域名/IP/组织/个人生成带引用的情报档案，并提供实时信息流警报和监控列表
mind_research	3	启动自主深度研究任务
mind_train	7	自我训练会话 + 将聊天保存到知识图谱
mind_social	14	公共信息流帖子、社交信息流、社群、点赞、评论 — ⚠️ 发布内容会写入用户的 PUBLIC 信息流，仅在用户明确请求时调用
mind_social_analytics	6	YouTube/LinkedIn/X/Twitch 频道统计、近期视频表现、留存率/流量/情绪分析、目标进度
mind_profile	9	个人资料、自定义系统提示词、LLM 模型选择
mind_trader	25	TraderMIND — Agent 化交易引擎：实时信息流、MIND Vision 预测（最新预测锥体 + 已解析历史记录 + 每根柱线的评分）、蜡烛图、周期、校准诚实度曲线、引擎运行状况、保存/加星/点赞 + 撤销、笔记 + 引擎可学习的结构化反馈、完整交易日志 CRUD、个性化洞察。引擎读取和计数为公开操作（即使没有密钥或密钥无效也可使用）；只有以你的身份执行操作时，才会验证密钥所有者身份
mind_insights	7	自主学习引擎洞察、每周摘要、反馈
mind_automate	6	计划自动化、事件触发器、执行历史
mind_notify	4	通知、标记为已读、统计
mind_agents	25	仅限管理员。 Agent Command Center — 列出/搜索/获取/创建/更新/删除 Agent、心跳、探测、活动日志、从 MIND 导入、建立规范化 Agent 集群、关联发票、转移所有权 + 与其他账户共享 Agent
mind_tickets	7	仅限管理员。 Agent 工单队列 — 为任何 Agent 创建、查看、回复（评论）、分类处理、解决和删除客户反馈/错误报告/创意建议
mind_personas	17	仅限管理员。 Influencer Factory Command Center — 合成角色 CRUD、人脸锚点 + 变体、ElevenLabs 语音、各平台个人简介、Blotato 账户注册
mind_accounts	6	多 MIND 账户 — 列出你可访问的 MIND、创建新 MIND、删除你拥有的 MIND、管理所有者/查看者、发送电子邮件邀请
mind_list_templates	1	列出 16 个 Front Layer 类型化文档模板
mind_get_template	1	获取一个 Front Layer 模板的完整规范
mind_save_typed	1	保存已填写的 Front Layer 文档及其类型标签
mind_bootstrap_templates	1	将全部 16 个 Front Layer 模板植入 MIND 租户
mind_mindmap	6	MIND Mind Map (m-i-n-d.ai/#/mind-map) — 可视化画布：列出/获取/创建/更新/删除、读取公开分享的思维导图。分享、协作者以及根据提示词/项目进行 AI 生成的功能仅在 Web 应用中提供（仅限 JWT，仅限人工操作）
mind_moneymind	37	MoneyMIND (m-i-n-d.ai/#/moneyMIND) — 账户、交易 + 拆分 + 规则、预算、定期账单、净资产、储蓄目标、信用、警报、账单协商、银行对账单
mind_budget	19	13 周现金流规划工具 (m-i-n-d.ai/#/budget) — 单元格、行、季度、差异、结转、自动填充/根据银行对账单生成
mind_sheets	14	Airtable 风格的表格 (m-i-n-d.ai/#/sheets) — 表格、列、行、CSV 导出
mind_email	14	MIND Email Manager (m-i-n-d.ai/#/email) — 收件箱、邮件串、搜索、AI 草稿、⚠️ 发送（对外）、语音/语气偏好
mind_checklists	13	Kanon 清单 (kanon.theastraway.com)，可关联 Life 事项或任务 — 模板、执行记录、toggle_item、进度汇总
mind_sign	12	MIND Sign 电子签名 (m-i-n-d.ai/#/mindsign) — 信封、字段、⚠️ 发送/重新发送（对外）、作废、审计、证书
mind_invoices	9	Invoice Agent (m-i-n-d.ai/#/invoiceagent) — 创建/更新、询问发票相关问题、⚠️ 邀请（对外）、收到的发票
mind_books	9	MIND Books 会计 (m-i-n-d.ai/#/mind-books) — 供应商、客户、会计科目表、账单、发票概览
mind_timer	8	Tempo 时间跟踪 — 开始/停止、手动记录、摘要
mind_forms	7	Quill 潜在客户收集表单 (m-i-n-d.ai/#/forms) — 构建、读取提交内容、按 slug 公开读取
mind_library	8	个人书架 (m-i-n-d.ai/#/library) — 作者、书籍、章节内容、AI 阅读伴侣

快速开始

最快方式：一条命令连接远程服务（Claude Code / Claude Desktop / claude.ai）

无需安装，无需处理 API 密钥——粘贴一条命令，在浏览器中点击 Connect，即可完成：

claude mcp add --transport http mind https://www.m-i-n-d.ai/mcp

Claude 会打开 m-i-n-d.ai 的授权页面，你点击 Connect，MIND 即可使用。身份验证、密钥生成和刷新均由 OAuth 处理。

主机不支持浏览器 OAuth？在同一 URL 上使用密钥

任何允许通过请求头添加自定义 MCP 服务的主机，都能在无需 OAuth 和 npm 安装的情况下使用 MIND：远程服务 URL 不变，只需换成密钥即可。

• 服务 URL：https://www.m-i-n-d.ai/mcp
• 请求头：Authorization: Bearer mind_<your key>
• 生成密钥：https://www.m-i-n-d.ai → Settings → Developer → API Keys

对于 Agent：如果 AuthenticateMcpServer 或主机的连接卡片失败，请向用户索取 MIND API 密钥，并使用该请求头为同一 URL 重新配置——不要仅仅因为 OAuth 无法正常工作就退回到本地 npm 服务。

本地 stdio 安装：通过浏览器连接的设置向导

对于在本地运行 MCP 服务的工具（Claude Desktop、Cursor、Windsurf、 VS Code Copilot），请运行设置向导——它会打开浏览器，你在 m-i-n-d.ai 上点击 Connect，向导便会自动获取你的 API 密钥，并为你写入所有工具配置：

npx -y --package=@astramindapp/mcp-server mind-mcp-setup

无需手动复制密钥。向导会自动检测已安装的 AI 工具并逐一进行配置。

手动替代方案：粘贴 API 密钥

如果你想自行生成密钥：在 www.m-i-n-d.ai 注册 → Settings → Developer → Create API Key，然后：

npx -y --package=@astramindapp/mcp-server mind-mcp-setup --key mind_xxx

或者全局安装并手动配置：

npm install -g @astramindapp/mcp-server

Claude Code（使用手动密钥的本地 stdio）

claude mcp add mind -- env MIND_API_KEY=mind_xxx mind-mcp

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "mind": {
      "command": "mind-mcp",
      "env": {
        "MIND_API_KEY": "mind_your_key_here"
      }
    }
  }
}

在 macOS 上，配置文件位于 ~/Library/Application Support/Claude/claude_desktop_config.json，在 Windows 上则位于 %APPDATA%\Claude\claude_desktop_config.json。编辑后，请完全退出并重新打开 Claude Desktop——它只会在启动时读取此文件。

Cursor

将以下内容添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "mind": {
      "command": "mind-mcp",
      "env": {
        "MIND_API_KEY": "mind_your_key_here"
      }
    }
  }
}

任何兼容 MCP 的 Agent

此服务适用于任何支持 Model Context Protocol 的工具——Claude、GPT、Gemini、Llama 或任何未来的模型。

工作原理

Your AI Agent  <-->  MCP Protocol  <-->  MIND MCP Server  <-->  Personal Knowledge Graph
                                                                  |
                                                           Emotional Intelligence
                                                           Autonomous Learning
                                                           CRM + Life + Social

1. Agent 在会话开始时调用 mind_context → 加载身份、规则和优先事项
2. Agent 在作出决策前调用 mind_query → 检索相关记忆
3. Agent 在完成任务后调用 mind_remember → 存储结果和经验
4. Agent 调用 mind_sense → 读取用户的情绪状态，以调整回复
5. Agent 调用 mind_insights → 展示自主模式检测结果
6. 下一个会话中，任何 Agent 都能获得完整上下文。知识不断积累。

MIND 的不同之处

与扁平文件记忆（MEMORY.md）相比

	扁平文件	MIND
大小	约 20K 个字符，且会被截断	无限知识图谱
检索	每轮都加载所有内容	通过语义搜索仅检索相关记忆
结构	非结构化文本	包含实体、关系和情绪权重的图谱
跨 Agent	仅限一个工具	所有 AI Agent 共享
智能	无	自主模式检测 + 情绪编码

与其他 MCP 记忆服务相比

	Anthropic Official	Mem0	Graphiti/Zep	MIND
工具	8	4	9	24
知识图谱	基础（JSON）	无（向量）	有（Neo4j）	有（每位用户专属的 MIND 图谱）
情绪智能	无	无	无	有（专利申请中）
CRM	无	无	无	有
生活管理	无	无	无	有
社交功能	无	无	无	有
自我训练	无	无	无	有
研究 Agent	无	无	无	有
自动化	无	无	无	有
移动应用	无	无	无	有

工具参考

mind_query — 搜索你的知识图谱

query: "What did I decide about the authentication approach?"
mode: "hybrid"  // hybrid (default), mix, global, local, naive

返回已存储文档、条目和动态帖子的检索上下文，并注明来源——这是供调用模型综合处理的原始图谱上下文，而非已完成的答案。不使用 MIND LLM，也不消耗积分。设置 retrieve_only=false 可获取由 MIND 撰写的答案（会消耗积分）。

mind_remember — 存储和管理内容

操作	描述
create	存储内容。私有：document、entry（默认）。公开：feed_post — 发布到用户的公开社交动态，除非用户明确说“发布”“分享”“发推”“动态”或“发到我的动态”，否则绝不要使用。（thought 是已弃用的 feed_post 别名。）
delete	按 ID 删除
search	按查询查找条目／动态帖子
get	按 ID 获取指定项目
list	分页列出所有内容

mind_folders — 将文档整理到文件夹中

文件夹是文档托盘上的展示层——无论文件夹如何，知识图谱仍会为每份文档编制索引并进行检索。

操作	描述
list	列出所有文件夹及各自的文档数量
create	创建文件夹（可选择嵌套在父文件夹下）
rename	更改文件夹名称
move	将文件夹重新嵌套到其他父文件夹下
delete	删除文件夹——其文档和子文件夹上移一级；不会删除任何内容
move_documents	将一份或多份文档归入文件夹

mind_context — 加载持久化上下文

在会话开始时加载五个结构化部分：

• 灵魂 — 核心身份、使命、个性
• 用户 — 用户是谁、其角色和偏好
• 规则 — 操作约束、行为准则
• 优先事项 — 当前目标、进行中的项目、截止日期
• 近期动态 — 最新活动、结果和决策

mind_life — 生活管理 + 日历

操作	描述
list、create、update、complete、delete、move、get	完整的任务／目标 CRUD
bulk_delete	一次调用删除最多 200 个生活事项（item_ids 数组）
calendar_list、calendar_create、calendar_update、calendar_delete	日历事件
stats	生产力指标和完成率

mind_crm — 联系人关系管理

操作	描述
list、create、update、delete、get	带有流程阶段的联系人 CRUD
log_activity	记录电话、电子邮件、会议和备注
list_activities	查看互动历史

mind_tasks — 全站任务

可分配、可完成、可报告的工作事项。任务可以关联到生活项目（parent_type: "life_item"）、CRM 联系人（"contact"）、Agent（"agent"），也可以独立存在。可将任务分配给 MIND 成员、Agent 或外部电子邮件地址。

操作	描述
list	按状态、优先级、上级、受派人或逾期情况列出／筛选任务
create	创建任务——关联到项目／联系人／Agent，分配任务并设置截止日期
get、update、delete	任务 CRUD
complete、reopen	标记任务为已完成或重新打开
assign	分配／重新分配给成员／Agent／外部对象；可选择触发 Agent
reports	完成情况分析——数量、逾期任务、按受派人统计、8 周工作量

mind_tasks({ action: "create", title: "Follow up with Acme",
             parent_type: "contact", parent_id: "<contact_id>",
             assignee_type: "agent", assignee_id: "fundraising-agent",
             dispatch_agent: true, due_date: "2026-06-01" })

mind_tasks({ action: "reports" })

mind_sense — MINDsense 情绪智能

操作	描述
state	当前情绪状态（效价、唤醒度、趋势、敏感度）
signals	近期情绪信号及其强度和来源
timeline	历史情绪数据
kg_weights	按情绪重要性加权的实体
spikes	检测到的情绪峰值
acknowledge	标记已确认情绪峰值
summary	AI 生成的情绪摘要

mind_research — 自主研究

操作	描述
start	针对任意主题启动深度研究任务
status	查看任务进度
list	查看所有研究任务

mind_train — 自我训练

操作	描述
start	开始引导式训练（基础知识、网络、专业知识、历史、目标、自由形式）
chat	发送训练消息
status、list_sessions、pause、resume	会话管理
save_chat	将任意聊天对话保存到知识图谱中

mind_social — 社交层

操作	描述
create_thought、get_thought、delete_thought、like_thought	管理公开动态帖子 — ⚠️ create_thought 会写入用户的公开动态，仅在用户明确请求时调用（参见工具描述）
feed、user_feed、search_feed	浏览社交动态
create_community、list_communities、get_community	社区管理
join_community、leave_community	成员资格管理
create_post、list_posts	社区帖子

mind_profile — 个人资料与偏好设置

操作	描述
get、update	个人资料管理
get_chat_prompt、set_chat_prompt	自定义聊天系统提示词
get_thought_prompt、set_thought_prompt	自定义动态帖子生成提示词（用户要求 MIND 起草帖子时使用）
get_model、set_model、list_models	LLM 模型选择（50 多种模型）

mind_insights — 自主学习引擎

操作	描述
list	查看近期检测到模式的洞察
unread_count	统计未查看的洞察
view、feedback	标记为已查看、评价是否有帮助
analyze	按需触发分析
weekly_summary	每周智能摘要
context	ALE 上下文数据

mind_automate — 自动化

操作	描述
list、create、update、delete	自动化的增删改查
run_now	立即触发
history	执行日志

mind_notify — 通知

操作	描述
list	查看所有通知
mark_read、mark_all_read	通知阅读管理
stats	通知概览

mind_admin — 管理与精选 Minds 门户

需要具备管理员权限的 MIND API 密钥。为 https://m-i-n-d.ai/#/admin/featuredmindsportal 上的所有功能提供支持 — 任何 MCP 客户端（Claude Code、Cursor、Windsurf、通过 MCP 使用的 n8n、自定义 Agent）都可以端到端地操作这些功能。

用户创建 + 等级/额度

操作	描述
create_user	创建新的 MIND 账户；可选择生成 API 密钥
list_users	列出带分析数据的用户，可按活动时间范围和 source 租户筛选
update_user_tier	更改订阅等级（free / pro / enterprise）
adjust_user_credits	增加（+）或扣除（–）额度

精选 Minds 门户 — 完整 CRUD

目录（featured_minds 集合）和关联的所有者资料（user_profiles）会一起编辑，因此更改会立即同步到 https://m-i-n-d.ai/m/{username}。

操作	说明
create_featured_mind	将用户的 MIND 推荐到精选目录
list_featured_minds	列出所有精选 mind，包含 mind_id、display_order、featured、is_public
get_featured_mind_full	一次往返即可获取完整视图：featured_mind 文档 + 关联的 user_profile + available_models 目录（门户侧边栏加载的内容）
update_featured_mind	目录字段：title、subtitle、description、tags、featured、display_order、is_public、avatar_url、banner_url、price
update_featured_mind_owner_profile	写入关联用户的 user_profiles：preferred_llm_model、public_mind_prompt（≤3000 个字符）、chat_temperature（0.0–2.0）、chat_reasoning_effort（minimal/low/medium/high，仅限思考模型）、public_mind_enabled、public_mind_tagline/greeting/persona、bio、avatar_url、banner_url。将 preferred_llm_model 设为 null 可清除该值并回退到平台默认值。
reorder_featured_minds	通过 ordered_mind_ids: string[] 批量设置 display_order——列表中的索引将成为顺序。支持幂等操作。
delete_featured_mind	从目录中移除。用户底层的 MIND 会保留。

操作示例 — 通过 MCP 更改精选 MIND 的模型和提示词

mind_admin({ action: "list_featured_minds" })
// → grab the mind_id you want

mind_admin({ action: "get_featured_mind_full", mind_id: "<id>" })
// → see current owner_profile + the full available_models catalog

mind_admin({
  action: "update_featured_mind_owner_profile",
  mind_id: "<id>",
  preferred_llm_model: "anthropic/claude-sonnet-4.6",
  chat_temperature: 0.7,
  public_mind_prompt: "You are Anthony's public MIND. Answer in his voice."
})
// → next anonymous chat at /m/{username} uses the new model + prompt + temp

mind_agents — Agent 指挥中心（管理员）

整个工作区 Agent 集群的权威注册表——涵盖在 VPS 上运行、计划中和已归档的 Agent。解决了反复出现的“每次 Claude Code 会话都要从头重新发现我的 Agent”的问题。由 MIND 后端的 /admin/agents 提供支持。需要管理员 API 密钥。

操作	说明
list	使用筛选条件列出/搜索 Agent（list_status、list_host、list_tag、list_query 自由文本），并返回整个集群的统计数据
get	获取单个 Agent 的详情，并内联显示最近 20 条活动记录
create	注册新的 Agent 记录（slug 必须唯一）
update	部分更新——名称、描述、状态、频率、主机、职责等
delete	软归档（默认），或设置 hard=true 永久移除
heartbeat	从 Agent 运行时发送心跳（更新 last_heartbeat 和 current_job）
probe	主动存活探测（HTTP health_url 或 OpenClaw 网关）——将结果记录为活动
log_activity	追加手动活动记录（备注、状态更改、错误）
list_activities	获取单个 Agent 的分页活动历史
set_status	快捷更新——将状态切换为 running/paused/planned/archived/error
set_current_job	快捷更新——记录 Agent 当前正在执行的任务
import_from_mind	从 MIND agent-identity 文档中补充 Agent 记录
seed_known	幂等地更新权威种子列表（仅添加；设置 overwrite=true 可重置）
transfer_owner	将 Agent 移至另一个 MIND 账户的看板（owner_username——该账户必须存在）
share	授予另一个账户访问权限——grantee_username + share_role（owner = 完全控制，viewer = 只读）
list_shares	列出 Agent 已共享给的所有账户
revoke_share	通过 share_id 撤销共享授权（来自 list_shares）

// Before scaffolding a new agent — check what exists
mind_agents({ action: "list" })

// After non-trivial work — keep the registry honest
mind_agents({
  action: "heartbeat",
  slug: "social-media-manager",
  current_job: "drafting LinkedIn carousel for Friday"
})

// Promote a planned agent to running
mind_agents({ action: "set_status", slug: "audit-agent", status: "running" })

// Hand an agent to a teammate's board, or share it read-only
mind_agents({ action: "transfer_owner", slug: "audit-agent", owner_username: "jane" })
mind_agents({ action: "share", slug: "audit-agent", grantee_username: "sam", share_role: "viewer" })

// Search the fleet by free text — slug, name, description, or tags
mind_agents({ action: "list", list_query: "atlas" })

界面：访问 https://m-i-n-d.ai/agents（仅限管理员）以可视化方式浏览整个集群。

mind_tickets — Agent 工单队列（管理员）

Command Center 中的每个 Agent 都有一个工单队列，包含客户反馈、批评、创意、功能请求和错误。与 Agent 共享的咨询客户可以提交工单；Agent 的所有者负责分类处理并解决。每个工单都会自动分配给 Ernie 分类处理 Agent，并同步到 MIND Life，作为一项任务。由 /admin/agents/{slug}/tickets 提供支持。需要管理员 API 密钥。每次调用都必须提供 agent_slug。

操作	说明
list	列出 Agent 的所有工单及未完成／总数统计；可选的 status 筛选条件
get	获取一张工单及其完整评论串
create	提交新工单（必需提供 title；kind、body、priority 为可选项）
comment	回复工单——在评论串中添加回复（body = 回复内容）
update	分类处理——更改 status、priority、kind 或重新分配（assignee）
resolve	快捷操作——将工单标记为 resolved
delete	删除工单、其评论及其同步到 Life 的任务

kind：feedback · critique · idea · feature · bug status：open → triaged → in_progress → resolved → closed priority：low · medium · high · urgent

// File a bug against an agent
mind_tickets({ action: "create", agent_slug: "social-media-manager",
               kind: "bug", priority: "high",
               title: "Carousel export drops the last slide",
               body: "Repro: 7-slide deck exports as 6." })

// Answer it, then resolve it
mind_tickets({ action: "comment", agent_slug: "social-media-manager",
               ticket_id: "<id>", body: "Fixed in the export batch size — verified." })
mind_tickets({ action: "resolve", agent_slug: "social-media-manager", ticket_id: "<id>" })

mind_accounts — 多 MIND 账户

“MIND” 是一个知识图谱账户。一个人可以拥有多个 MIND，也可以获授多个 MIND 的访问权限（工作、研究、客户的 MIND、共享团队 MIND），并在它们之间切换。此工具可让 Agent 发现和管理这些账户。由 MIND 后端的 /developer/v1/accounts 提供支持。

操作	说明
list	列出 API 密钥所有者可访问的所有 MIND，以及其角色（owner/viewer）和当前活跃的 MIND
create	创建一个由你拥有的全新 MIND（传入 label）
delete	永久删除一个由你拥有的 MIND——账户、授权和邀请（传入 mind_username）
members	查看一个由你拥有的 MIND 的所有者、查看者和待处理邀请（传入 mind_username）
grant	授予现有 MINDapp 用户所有者／查看者访问权限（mind_username、grantee_username、role）
invite	通过电子邮件发送邀请，共同拥有或查看 MIND（mind_username、email、role）

// Discover every MIND you can reach
mind_accounts({ action: "list" })

// Create a dedicated MIND for a new workstream
mind_accounts({ action: "create", label: "Acme Corp Research" })

// Grant a teammate read-only access
mind_accounts({
  action: "grant",
  mind_username: "acme_research_a1b2c3",
  grantee_username: "teammate",
  role: "viewer"
})

注意：owner = 完全访问权限，viewer = 只读。需要在 MIND 后端启用 MULTI_MIND_ACCOUNTS_ENABLED；如果此功能已关闭，list 会返回 enabled: false。

合作伙伴集成

合作伙伴应用可以使用合作伙伴密钥，以编程方式创建 MIND 账户：

curl -X POST https://m-i-n-d.ai/admin/users/create \
  -H "X-API-Key: mind_partner_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "newuser",
    "email": "[email protected]",
    "password": "securepassword",
    "generate_api_key": true
  }'

返回一个 JWT 和永久 API 密钥。你的应用会存储该 API 密钥，并在此后代表该用户进行所有 MCP/API 调用时使用它。

环境变量

变量	必需	默认值	说明
MIND_API_KEY	是	—	你的 MIND Developer API 密钥
MIND_BASE_URL	否	https://www.m-i-n-d.ai	MIND API 基础 URL

编程使用

import { createMindMcpServer, MindClient } from "@astramindapp/mcp-server";

const client = new MindClient({
  baseUrl: "https://www.m-i-n-d.ai",
  apiKey: "mind_xxx",
});

const server = createMindMcpServer(client);
// Connect to any MCP transport

专利

MIND 的核心技术——包括情绪加权知识图谱编码，以及通过 Model Context Protocol 实现跨 Agent 持久记忆——目前正在申请专利。专利申请中。

故障排除

• 点击“Connect”后打开了 MIND 网站，而不是建立连接——这是非 www 端点中的一个错误，已于 2026 年 7 月修复。请使用 https://www.m-i-n-d.ai/mcp（带 www）并重试。
• 我的工具中没有“Connectors”选项——如果你使用的是 Claude Code，请使用上方的 Claude Code 单行命令；对于其他兼容 MCP 的工具，请使用本地 npm 安装（npm install -g @astramindapp/mcp-server）。
• npx 提示“could not determine executable to run”或一直卡住——npx -y <pkg> 只会运行名称与软件包最后一个路径段相同的 bin（mcp-server），因此单独运行 npx -y @astramindapp/mcp-server 会失败；添加 @latest，再在末尾加上 mind-mcp-setup，也只会将其作为参数传入，而不会选择该 bin。请使用 npx -y --package=@astramindapp/mcp-server mind-mcp-setup（或 mind-mcp），这适用于所有版本；或者先进行全局安装（npm install -g @astramindapp/mcp-server）。
• 我有多个 MIND 账户——为每个账户添加一次连接器，并使用不同的名称（例如 mind-personal、mind-work）；每次点击 Connect 时，都可以在授权同意页面上选择账户。

链接

• 网站：www.m-i-n-d.ai
• GitHub：theastraway/mind-mcp-server
• npm：@astramindapp/mcp-server
• MCP 文档：m-i-n-d.ai/mcp.html

许可证

MIT — Astra AI, Inc.