Raziel

Raziel

Raziel 是 Tide 的 MCP ——它为 AI 编码 Agent 提供正确实现 TideCloak 所需的知识。

这个 MCP 服务为你的 AI 助手提供有关 Tide 身份验证、门限密码学、端到端加密、IGA 治理和 Forseti 智能合约的深入知识，还能对现有系统进行安全缺口分析，并提供自托管与托管服务方面的指导。你的 AI 不再靠猜测，而是遵循经过验证的操作指南。

快速开始

Claude Code（命令行或 VS Code 扩展）

运行这条命令：

claude mcp add tide-pack -- npx -y @tideorg/mcp

完成。开始对话，让 Agent 为你的应用添加 Tide 身份验证。

项目级配置（适用于任何 MCP 客户端）

在项目根目录中添加 .mcp.json 文件：

{
  "mcpServers": {
    "tide-pack": {
      "command": "npx",
      "args": ["-y", "@tideorg/mcp"]
    }
  }
}

适用于：Claude Code、Cursor、Windsurf、Cline，以及任何兼容 MCP 的工具。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "tide-pack": {
      "command": "npx",
      "args": ["-y", "@tideorg/mcp"]
    }
  }
}

Cursor

打开 Settings > MCP Servers > Add Server：

• 名称：tide-pack
• 命令：npx
• 参数：-y @tideorg/mcp

或者将其添加到项目根目录中的 .cursor/mcp.json。

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "tide": {
      "url": "https://mcp.tide.org/mcp"
    }
  }
}

也可以用于本地配置："command": "npx", "args": ["-y", "@tideorg/mcp"]

Zed

添加到 Zed 设置（~/.config/zed/settings.json）：

{
  "context_servers": {
    "tide": {
      "command": {
        "path": "npx",
        "args": ["-y", "@tideorg/mcp"]
      }
    }
  }
}

注意：Zed 使用 context_servers（而不是 mcpServers），且目前不支持基于远程 URL 的 MCP 服务；请使用 npx 命令。

OpenAI Codex CLI

添加到 ~/.codex/config.json：

{
  "mcpServers": {
    "tide": {
      "command": "npx",
      "args": ["-y", "@tideorg/mcp"]
    }
  }
}

注意：Codex CLI 目前仅支持基于 stdio 的 MCP 服务；请使用 npx 命令。

Lovable

Lovable 的构建 Agent 可以通过 Custom MCP 连接器使用 Raziel（所有套餐均可用）。在 Lovable 项目中，打开 Connectors → Custom MCP（底部的卡片）并添加：

• 服务名称： Raziel
• 服务 URL： https://mcp.tide.org/mcp
• 身份验证： No authentication

然后告诉 Agent 使用它，例如："在编写任何身份验证代码之前，使用 Raziel 连接器获取 TideCloak 操作指南。"

以下两点容易让人困惑：

• 由你来添加，而不是 Agent。 Lovable 的 Agent 无法添加连接器，也无法在预构建目录中找到 Tide（Tide 不是目录合作伙伴）。请在 Connectors 面板中自行添加，然后告诉 Agent 使用它；否则它会说自己“无法连接”。
• 这是构建时连接器。 它会在 Lovable 生成应用时为其 Agent 提供经过验证的 Tide 知识；它不会在已发布的应用中运行。你仍需按照常规方式将 TideCloak 接入生成的应用。

AI 可以用它做什么

连接后，你的 AI 助手可以：

• 分析现有系统中的安全缺口，并逐一说明 Tide 如何解决（同时如实列出“Tide 无法解决的问题”）
• 为新的或现有的 Next.js/React 应用添加 Tide 身份验证
• 使用服务端 JWT + DPoP 验证保护 API 路由
• 使用 Tide 的 IGA 治理设置基于角色的访问控制
• 部署 Forseti 智能合约，实现受策略治理的加密和签名
• 引导配置 TideCloak，使用自托管（Docker）或合作伙伴托管（Skycloak），直至完成 Realm 配置
• 诊断问题，例如登录失败、缺少角色、CORS 错误
• 遵循安全不变量，避免常见的身份验证错误

试试看

完成设置后，在你的 AI 编码工具中试试以下提示词：

对我的应用进行安全分析，并说明 Tide 会带来哪些改变

为我的 Next.js 应用添加 Tide 身份验证

我有一个现有应用，已经实现了身份验证——帮我迁移到 Tide

帮我设置用户之间的加密数据共享

帮我创建一个用于多管理员审批的 Forseti 合约

内容一览

类别	数量	示例
核心规范	15 个文件	安全不变量、反模式、安全差距映射、IGA 变更请求 API、托管选项、框架矩阵、故障排除
操作手册	18 个分步指南	添加身份验证、保护 API、验证 JWT、部署 TideCloak、设置 E2EE、配置托管的 TideCloak
技能	11 个可组合角色	设置、集成、安全分析、路由/API 保护、审查、QA 门禁
场景	5 个参考架构	密码管理器、签名服务、加密聊天、治理面板
提示词	5 个入门提示词	安全差距分析、保护现有应用、迁移身份验证、管理员审批、客户门户

远程服务（无需安装）

我们托管了 MCP 服务，因此你无需安装任何内容。只需添加 URL：

{
  "mcpServers": {
    "tide": {
      "url": "https://mcp.tide.org/mcp"
    }
  }
}

无需 Node.js。无需 npx。适用于任何支持远程服务的 MCP 客户端。

自托管

想运行自己的实例？从 Docker Hub 拉取：

docker run -p 3000:3000 tideorg/mcp

也可以从源代码构建：

docker build -t tideorg/mcp .
docker run -p 3000:3000 tideorg/mcp

然后将 MCP 客户端指向 http://localhost:3000/mcp。

可选：设置 API_TOKEN 环境变量以要求使用 Bearer 令牌进行身份验证：

docker run -p 3000:3000 -e API_TOKEN=your-secret tideorg/mcp

要求

• 远程服务：无（只需支持远程 URL 的 MCP 客户端）
• npm/npx 安装：Node.js 18+
• 自托管 Docker：Docker

启动时无需 TideCloak 实例——Agent 会引导你完成设置。

隐私

MCP 服务为只读。在本地运行（npx）时，它不会收集任何信息——没有账户、没有遥测数据、也不存储数据。托管的 mcp.tide.org 端点会记录汇总的使用地理位置（仅大致位置，绝不记录请求内容或工具参数），以了解其使用地区。详情请见 PRIVACY.md。

链接

• TideCloak — 身份平台
• npm 软件包 — @tideorg/mcp
• 隐私政策
• Tide Foundation — Tide 背后的组织