# Arkme 开放平台接入导航

Arkme 把同一组业务能力分别通过 REST API 和 MCP Server 对外提供。Arkme DSH Plugin 作为 MCP Client 使用这些能力。

## 开始接入

1. 登录 [开发者控制台](/console)，填写名称并创建个人 API Key。
2. 立即复制只显示一次的 `arkme_` Key。
3. 根据调用方选择接入方式。

| 调用方 | 接入方式 | 入口 |
| --- | --- | --- |
| 服务端、脚本或桌面程序 | REST API | [REST API 接入指南](rest/quickstart.md) |
| MCP Host 或外部 Agent | MCP | [MCP 接入指南](mcp/quickstart.md) |
| DeepSeek Harness | Arkme DSH Plugin | [DSH Plugin 接入指南](dsh/quickstart.md) |

API Key 的创建和安全使用参见 [API Key 使用指南](api-key.md)。同一把 Key 可用于 REST、MCP 和 DSH Plugin，新增能力后无需重新创建。

REST 使用 HTTP、JSON 和 Arkme 响应包；MCP 使用 Streamable HTTP、JSON-RPC 和运行时 Tool 合同。REST 的 OpenAPI 3.1 文件不描述 MCP Tool。

公开能力的业务输入不接受 `user_id`。服务始终使用 API Key 所属用户。