Oh MCP Server

Open Horizons MCP服务器

](https://www.npmjs.com/package/@cloud-atlas-ai/oh-mcp-server)

模型上下文协议（MCP）服务器 开阔视野 -使AI代理能够读取和写入战略对齐上下文。

这是什么？

Open Horizons MCP Server将AI编码助手（如Claude Code）连接到您的战略对齐框架。AI代理可以：

• 阅读你的战略背景：查询任务、目标、倡议和任务
• 记录决策：记录为什么做出与战略目标相关的选择
• 保持一致：每次代码更改都可以追溯到一个任务

结果： AI不仅编码速度快，而且编码与你的战略相一致。

快速开始

1.获取API密钥

1. 注册地址： App.openhorizons.me。
2. 首选 设置>API密钥
3. 创建新的API密钥

2.选择您的设置方法

选项A：插件设置（建议用于Claude代码）

该插件提供了一个指导 /oh-mcp:setup 命令：

# Add the marketplace
claude plugin marketplace add cloud-atlas-ai/oh-mcp-server

# Install the plugin
claude plugin install oh-mcp@oh-mcp

# Restart Claude Code, then run:
/oh-mcp:setup

选项B：直接CLI设置（不需要插件）

使用 claude mcp add 直接命令：

claude mcp add oh-mcp -s user \
  -e OH_API_URL=https://app.openhorizons.me \
  -e OH_API_KEY=your_api_key_here \
  -- npx -y @cloud-atlas-ai/oh-mcp-server

这将MCP服务器添加到 ~/.claude.json 因此，它在所有项目中都可用。

选项C：项目特定设置

添加到您的项目 .mcp.json:

{
  "mcpServers": {
    "oh-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cloud-atlas-ai/oh-mcp-server"],
      "env": {
        "OH_API_KEY": "your_api_key_here",
        "OH_API_URL": "https://app.openhorizons.me"
      }
    }
  }
}

3.验证

重新启动Claude Code，然后让Claude测试连接：

Try calling: oh_about

如果它有效，你会看到OH MCP工具可用！

可用工具

读取操作

• oh_get_contexts -列出所有上下文（个人和共享工作区）
• oh_get_endeavors -在特定背景下获得努力（任务、目标、倡议、任务）
• oh_get_endeavor -通过层次结构获取特定努力的详细信息
• oh_get_logs -获取某项努力的最新日志/决策
• oh_about -获取有关Open Horizons和此MCP服务器的信息

写入操作（努力）

• oh_create_endeavor -创建新的使命、目标、倡议或任务
• oh_update_endeavor -更新努力标题和/或描述
• oh_archive_endeavor -存档尝试（软删除）
• oh_unarchive_endeavor -恢复已存档的努力
• oh_set_parent -更改某项努力的父级（在层次结构中移动）
• oh_delete_endeavor -永久删除一个努力

写入操作（记录和学习）

• oh_log_decision -记录一项努力的决定、笔记或进展
• oh_update_log -更新日志条目的内容
• oh_delete_log -删除日志条目
• oh_create_metis_candidate -展示一个模式/学习，以供以后复习（metis=情境判断）
• oh_create_guardrail_candidate -提出应强制执行的约束/规则

写操作（考生）

• oh_create_metis_candidate -展示一个模式/学习内容，供以后复习
• oh_create_guardrail_candidate -提出约束/规则以供以后审查

写入操作（上下文）

• oh_create_context -创建新的共享上下文（工作区）
• oh_update_context -更新上下文标题和/或描述
• oh_move_endeavor -将努力转移到不同的环境中
• oh_delete_context -永久删除上下文
• oh_invite_to_context -通过电子邮件邀请具有角色（编辑或查看器）的用户

核心概念

Open Horizons使用四级对齐层次结构：

Mission (why you exist)
  └── Aim (outcome you want)
       └── Initiative (how you'll achieve it)
            └── Task (what you do today)

主要观点：

• 语境：努力生活的个人或共享空间
• 努力：层次结构中的任何节点（使命、目标、倡议、任务）
• 决策日志：捕捉到与努力相关的推理和进步
• 对齐每个任务都可以追溯到一个任务，所以你总是知道 *为什么*
• 梅蒂人：情境判断——从实际工作中获得的模式和经验
• 护栏：防止重复错误的可执行约束

学习捕获工作流程

当代理在工作中发现可重用的见解或约束时：

1. 代理创建候选人 -使用 oh_create_metis_candidate 或 oh_create_guardrail_candidate 浮出水面
2. OH应用程序中的人类评论 -候选人出现在app.openhorizons.me的Reflect模式UI中，供人工审核
3. 人以结构促发展 -在OH-app中添加结构化字段（违反期望、观察真实性、metis的后果；护栏的标题和覆盖协议）
4. 激活知识 -推广项目成为活跃的信息/护栏，为未来的代理工作提供信息

这种两步流程确保了质量——代理人以近乎零的摩擦标记“这很重要”的时刻，而人类则在OH应用程序中策划持久的知识。

用例

1.使用Claude Code进行战略编码

安装 超我 +OH MCP用于与战略背景相关的元认知反馈：

# Install superego (metacognitive advisor)
claude plugin marketplace add cloud-atlas-ai/superego
claude plugin install superego@superego

# Install OH MCP (strategic alignment)
claude plugin marketplace add cloud-atlas-ai/oh-mcp-server
claude plugin install oh-mcp@oh-mcp

# Restart Claude Code, then:
/superego:init
/oh-mcp:setup

现在，克劳德·科德将元认知反馈（超我）与战略情境（OH-MCP）联系起来。每个决定都会记录回您的对齐框架。

2.人工智能群体协调

在多代理系统中使用OH MCP可以：

• 执行前获取对齐包
• 记录每次代理运行的决策
• 在集群中保持治理约束
• 创建所有人工智能决策的审计跟踪

看 群对齐架构 了解详情。

3.自定义AI工具

将OH-MCP集成到您自己的AI工具中：

import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';

// Your MCP server can call OH API via the oh-mcp tools
// to read context and log decisions

环境变量

• OH_API_KEY -您的Open Horizons API密钥（必需）
• OH_API_URL -OH API基本URL（默认值： https://app.openhorizons.me)

全球安装（替代方案）

如果您更喜欢全局安装而不是 npx:

npm install -g @cloud-atlas-ai/oh-mcp-server

# Then use 'oh-mcp' command directly:
claude mcp add oh-mcp -s user \
  -e OH_API_URL=https://app.openhorizons.me \
  -e OH_API_KEY=your_api_key_here \
  -- oh-mcp

发展

# Clone the repo
git clone https://github.com/cloud-atlas-ai/oh-mcp-server.git
cd oh-mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run in dev mode
npm run dev

# Test manually
OH_API_KEY=your_key npm start

故障排除

“API密钥无效”

• 验证您的API密钥是否正确
• 确保您使用的密钥来自https://app.openhorizons.me/settings/api-keys

“连接失败”

• 检查https://app.openhorizons.me可访问的
• 验证您的防火墙/代理没有阻止连接

“找不到MCP服务器”或“/oh-MCP:无法识别安装程序”

• 这 /oh-mcp:setup 命令需要插件（请参阅上面的选项A）
• 如果没有插件，请使用选项B或C进行手动设置

“MCP服务器崩溃”

• 检查一下 dist/index.js 文件存在（运行 npm run build 如果缺失）
• 查看Claude Code的MCP日志以了解错误详细信息
• 尝试手动运行： OH_API_KEY= npx @cloud-atlas-ai/oh-mcp-server

相关项目

• 超我 -Claude Code的元认知顾问（与OH MCP完美搭配）
• 开阔视野 -战略对接平台

许可证

MIT许可证-请参阅 许可证 了解详情。

支持

• 问题:
• 电子邮件: hello@cloudatlas.ai