内容
# Guidewire MCP for Claude
[](https://github.com/jeremylongshore/guidewire-mcp-for-claude/actions/workflows/ci.yml)
[](./LICENSE)
[](./000-docs/blueprint/)
[](https://modelcontextprotocol.io)
[](https://claude.ai)
[](https://guidewire-mcp.intentsolutions.io/)
> 为 **Guidewire InsuranceSuite**（PolicyCenter、ClaimCenter、BillingCenter）定制的 MCP 服务器。使用 Claude 查询保险运营问题；操作员词汇触发写入。优先构建 Claude/Anthropic。
---
## 安装（Claude Code 插件）
```bash
/plugin install jeremylongshore/guidewire-mcp-for-claude
```
安装完成。Claude Code 克隆仓库，运行 `pnpm install`（`prepare` 钩子构建所有工作区），并注册 `policycenter` MCP 服务器。重启 Claude Code；5 个运营商词汇工具现在在您的工具目录中。
## 配置（4 个环境变量）
在您的 shell、`.env` 或 Claude Code 会话继承环境变量的位置设置这些变量。MCP 服务器在启动时读取它们。
| 变量 | 描述 |
|---|---|
| `GUIDEWIRE_OAUTH_CLIENT_ID` | Guidewire Hub 开发层级的 OAuth 客户端 ID |
| `GUIDEWIRE_OAUTH_CLIENT_SECRET` | 匹配的客户端密钥 |
| `GUIDEWIRE_TOKEN_ENDPOINT` | OAuth 令牌端点 URL — 您的租户的 Hub `/oauth2/v1/token` |
| `GUIDEWIRE_PC_BASE_URL` | PolicyCenter Cloud API 基本 URL — `https://<your-tenant>.pc.guidewire.net/pc/api` |
还没有开发层级的凭证？申请加入 [Guidewire 开发者计划](https://developer.guidewire.com/) — [知识库](https://github.com/jeremylongshore/guidewire-mcp-for-claude/blob/main/000-docs/005-DR-REF-guidewire-public-resources.md) 映射了所有公共的 Guidewire 接口，包括开发者访问路径。
## 使用它
在任何 Claude Code 会话中，询问保险问题：
> *"查找等待我的提交"*
> *"显示 **Acme Manufacturing** 的保单"*
> *"总结提交 **6-2845-1**"*
> *"为什么 **Acme** 账户不再活跃？"*
> *"打开提交 **6-2845-1**"*
MCP 服务器调用真实的 Cloud API，以运营商的词汇返回响应（`namedInsured`，而不是 `Account.insured`；`submissionNumber`，而不是 `jobNumber`），每次调用都写入哈希链审计跟踪。
## v0.1.0 版本内容
**5 个只读 PolicyCenter 工具**（E2 构建）：
- `find-submissions-waiting-on-me` — 指派给我队列
- `show-policies-for-this-insured` — 跨 LOB 保单查找
- `summarize-this-submission` — 提交完整叙述
- `did-we-lose-this-account` — 非续期/取消历史
- `pull-this-submission` — 单个提交详情
**6 个 E1 基础包**（每个服务器使用）— 所有包均发布在 `@intentsolutions/guidewire-*` 范围内：
- `@intentsolutions/guidewire-schemas` （Zod）
- `@intentsolutions/guidewire-observability` （OTel + pino + Sentry）
- `@intentsolutions/guidewire-auth` （Hub OAuth + JWT 传播）
- `@intentsolutions/guidewire-audit` （Postgres + 哈希链）
- `@intentsolutions/guidewire-client` （undici + 双键幂等性）
- `@intentsolutions/guidewire-mcp-runtime` （stdio + HTTP 传输）
135 个测试通过。架构图：[guidewire-mcp.intentsolutions.io](https://guidewire-mcp.intentsolutions.io)。
## 公共路线图上的下一步
| 史诗 | 标题 | 状态 |
|---|---|---|
| E1 | 基础（6 个包） | **已构建** |
| E2 | PolicyCenter MCP（只读 · 5 个工具） | **已构建** |
| E2.5 | 聚合查询工具（UW 经理 tranche） | 计划中 |
| E3 | 哈arness 库 + CLI（写入门控在计划/批准/审计/回滚后面） | 计划中 |
| E4 | 每租户配置文件加载器 | 部分 — 框架已在 [#75](https://github.com/jeremylongshore/guidewire-mcp-for-claude/pull/75) 中落地 |
| E5 | 起草工具（`draft-referral-note`、`draft-endorsement`） | 计划中 |
| E6 | 工作流 + 事件（webhook 接收器 + 事件-mcp） | 计划中 |
| E7 | ClaimCenter MCP | 计划中 |
| E8 | BillingCenter + 支付（单独的双控制 `payments-mcp`） | 计划中 |
| E9 | 生产者侧 MCP（MGA / 经纪人范围） | 计划中 |
| E10 | 上线 + 认证 CLI | 计划中 |
| E11+ | 发布到 `claude-code-plugins-plus-skills` 市场 | 部分 — 插件清单已在 [#76](https://github.com/jeremylongshore/guidewire-mcp-for-claude/pull/76) 中落地；市场列表待定 |
完整的每个史诗退出标准：[`000-docs/blueprint/07-ROADMAP.md`](./000-docs/blueprint/07-ROADMAP.md)。
## 硬性规则
- **无模拟。** 从第一天起使用真实的 Guidewire Cloud 端点。
- **运营商词汇，而不是 API 动词。** 工具名称是操作员实际会问的问题（`find-submissions-waiting-on-me`），而不是 API 形状（`search_policies`）。工具的实现会调用真实的 Guidewire 端点（`GET /job/v1/jobs?subtype=Submission&...`），并且配置文件中的 `field-aliases.yaml` 在响应返回之前会将 Guidewire 的原始字段名称翻译回操作员语言。外部层 = 操作员语言；内部层 = Guidewire 语言；翻译是产品。PR 审查拒绝 `search_*`、`get_*`、`list_*` 工具名称。
- **每个工具三种执行模式：** `read_only`、`draft_only`、`approved_execute` — 通过客户配置文件选择。
- **无写入，无审计，无策略，无幂等性。** 哈希链审计跟踪是强制性的。
- **从第一行开始可观察性。** OpenTelemetry + pino + Sentry 接入每个服务器 + 哈arness。
完整列表：[`CLAUDE.md`](./CLAUDE.md)。
## 每租户配置文件（高级）
默认的即插即用安装使用内存配置文件，涵盖所有 5 个 v0.1.0 只读工具。具有自定义 LOB 代码、类型列表、角色映射或字段别名的运营商通过 9-YAML 配置文件目录进行覆盖。参见
[`profiles/_template/README.md`](./profiles/_template/README.md) 和
[`profiles/oss-demo/`](./profiles/oss-demo/) 获取模式，然后运行：
```bash
node servers/policycenter-mcp/dist/cli.js --profile profiles/<your-tenant>
```
## 开发/贡献
```bash
git clone https://github.com/jeremylongshore/guidewire-mcp-for-claude.git
cd guidewire-mcp-for-claude
pnpm install # 准备钩子构建所有工作区
pnpm -r test # 135 个测试（TS 协调 / 单元 / 集成）
pnpm smoke-reach # 使用您的开发层级凭证 ping Guidewire 端点
# Cloud API 合同测试使用 Karate（Guidewire 的官方 OSS 测试框架，JDK 11 + Gradle）：
cd tests/contract
./gradlew test # 6 个 .feature 文件锻炼 v0.1.0 端点
```
合约层使用 Karate per [D-022](./000-docs/004-DR-DEC-architecture-decisions.md#d-022) — 与 Guidewire 自己的工程师回归测试其 Cloud API 版本相同的框架。编排层（配置文件加载、字段别名、哈arness 门控、审计链完整性）停留在 TypeScript / Vitest。
贡献指南：[CONTRIBUTING.md](./CONTRIBUTING.md)。 [5 个专业代理](./.claude/agents/) 自动审查运营商词汇工具设计、哈arness 合同语义、Guidewire Cloud API 正确性、MCP 安全性和权威文档引用。
## 设计 + 审计
- [主蓝图](./000-docs/blueprint/00-MASTER-BLUEPRINT.md) — 索引
- [架构决策 D-001..D-021](./000-docs/004-DR-DEC-architecture-decisions.md)
- [公共 Guidewire 文档映射](./000-docs/005-DR-REF-guidewire-public-resources.md) — 由图书管理员策划
- [11 名审计员人员小组](./000-docs/blueprint/audits/) — 安全、MCP 安全、哈arness 合同等。
## 许可证
[Apache-2.0](./LICENSE) — 与 Guidewire 开发者文档路径我们引用的许可证相同。
## 作者
Jeremy Longshore — 意图解决方案 ·
[intentsolutions.io](https://intentsolutions.io) ·
[jeremylongshore.com](https://jeremylongshore.com) ·
[startaitools.com](https://startaitools.com) ·
`jeremy@intentsolutions.io`
