Dactic

Dactic MCP

通过托管服务 **https://mcp.app.dactic.io/mcp**，将 MCP 客户端连接到您的 Dactic 工作上下文。您需要拥有 Dactic 账户，并有权使用所请求的功能。可用工具取决于您的账户和权限。

此仓库包含公开的客户端清单、安装指南，以及 stdio 启动器的完整源代码。启动器使用固定版本的 mcp-remote 传输和 OAuth 实现。后端处理仍由托管的 Dactic 服务负责。审核者和用户使用相同的集成。

预发布版本： npm 安装示例将在 @dactic/[email protected] 发布后提供。现在请使用本地检出版本。Marketplace 审批和生产环境中的身份验证验证情况，请参阅发布检查清单。

直接连接（推荐）

在客户端的 MCP 设置中，添加 URL 为 https://mcp.app.dactic.io/mcp 的 Streamable HTTP MCP 服务，然后完成客户端的 OAuth 登录和授权流程。此仓库中未嵌入 API 密钥。

对于 Cursor，将以下条目合并到现有的 MCP 配置中：

{"mcpServers":{"dactic":{"url":"https://mcp.app.dactic.io/mcp"}}}

对于 Claude Code，使用随附的 .mcp.json，或运行：

claude mcp add --transport http dactic https://mcp.app.dactic.io/mcp

仓库还包含 Cursor、Claude 和通用插件清单。若要在本地检查 Claude 插件，请运行 claude plugin validate .；若要启动本地会话，请运行 claude --plugin-dir /absolute/path/to/dactic-v1-mcp-public。有关 Marketplace 格式，请参阅客户端安装指南。

通过 stdio 连接

安装 Node.js 22.12 或更高版本。在检出目录中运行：

npm ci
npm run verify
node src/cli.js --help

将 examples/stdio.local.json 合并到宿主的配置中，并将其中的绝对路径替换为您的检出目录路径。从 MCP 宿主启动，以保持 stdin/stdout 连接。需要 OAuth 授权时，桥接程序会打开浏览器。请勿在客户端 JSON 中输入账户凭据。

npm 发布后，examples/stdio.npm.json 将通过 npx -y @dactic/[email protected] 运行相同的桥接程序。

无头环境和 Docker

如果您的账户支持 Dactic 持有者凭据，请通过 DACTIC_MCP_TOKEN 环境变量提供该凭据。在宿主的密钥设置或私有环境中配置该值；切勿将其提交到仓库。桥接程序会向子进程传递字面环境占位符，而不会将凭据作为进程参数传递。OAuth 和持有者凭据仍受后端常规权限检查约束。

docker build -t dactic-mcp:local .
docker run --rm -i -e DACTIC_MCP_TOKEN dactic-mcp:local

此方式使用已设置的宿主环境变量。请勿使用 -t：stdout 必须保持为干净的 MCP 流。无头 Docker 需要持有者凭据；此容器未配置交互式浏览器 OAuth 回调。

配置和诊断

变量	行为
DACTIC_MCP_TOKEN	可选的 bearer 凭据；省略时使用浏览器 OAuth
DACTIC_REQUEST_ID	可选的安全关联 ID；否则会创建一个 UUID
MCP_REMOTE_CONFIG_DIR	可选的 OAuth 缓存目录；其中包含凭据
DACTIC_MCP_URL	生产环境 URL 或用于本地验证的回环测试环境

OAuth 请求基础作用域 openid offline_access mcp/mcp:tools。 其他功能取决于服务授权和客户端许可；此启动器默认不会请求组织范围的使用权限。 OAuth 存储和刷新由 mcp-remote 处理，通常位于 ~/.mcp-auth。请像保护密码一样保护该缓存，切勿共享。

桥接器仅将协议消息写入 stdout。JSON 生命周期诊断信息 写入 stderr，并包含 request_id；该 ID 也会作为 X-Request-ID 发送给 服务。日志会对连接故障进行分类，并保留安全的堆栈函数帧；上游响应正文、授权 URL 和凭据 均会被丢弃。请通过 request_id 和事件 bridge.fail 或 bridge.dependency.fail 搜索诊断信息。连接建立超时设定为 15 秒， 响应头超时为 60 秒，正文空闲超时为 300 秒，浏览器授权回调超时为 120 秒。

遇到身份验证失败时，请使用主机的登录流程重新连接。遇到权限失败时，请检查账户访问权限；重复进行身份验证不会授予新权限。遇到网络错误时，请检查端点是否可用以及网络状态。仅向支持团队提供关联 ID。

公开源码范围

公开代码实现传输和集成配置。其中不包含检索引擎、内部提示词、数据库访问、生产基础设施或客户测试数据。服务返回的工具描述和架构对 MCP 客户端可见，也可能被目录检查记录下来。 请参阅审查范围、安全和 Dactic 隐私政策。

开发

npm run verify 会针对合成的回环 MCP 服务检查官方架构快照、清单一致性、 资源文件、打包边界和离线协议集成测试。测试不会联系 Dactic，也不会读取用户凭据。CI 会运行相同的检查，并构建非 root Docker 镜像。 CI 不会发布到任何注册表或市场。

源码采用 MIT 许可证。品牌和托管服务不在该许可证范围内；请参阅 NOTICE。