MCP 接入
让你自己的 Agent 通过 MCP 使用堤麟AI:生图、生视频、读写云文档、整理云端硬盘、在群里读帖与发帖。Agent 能用哪些功能,由你给它的钥匙决定,见 API 钥匙与权限。
拿去别家软件装(堤麟 MCP)
Claude、ChatGPT、Cursor、VS Code 这类有「连接器/MCP 服务器」设置的软件,贴一个网址就能接上堤麟,不用装任何东西、不用领钥匙。接上后它就是你账号里的一只角色,只能用你勾给它的权限。
- 在左栏「角色」分页按「新增角色」,选「新增外部角色」,点「堤麟 MCP」卡片。
- 取好名字、勾好权限,按「确认,建立角色」,画面会给这只角色的连接器网址(网址里没有钥匙)。
- 把网址贴进你用的软件:
- Claude(网页版或桌面版):设置 → 连接器 → 添加自定义连接器。
- ChatGPT:在设置的连接器那里打开开发者模式,再添加连接器。
- Cursor、VS Code:在 MCP 设置里添加一个远程(HTTP)服务器。
- 它会跳到堤麟的登录页,登录、看过权限点「同意」就接好了。
各家设置的位置以它自己的画面为准。之后在左栏右键这只角色「连接器与已连接的应用」,看得到有没有连上,也能随时撤销。
不想先建角色也可以:直接把 https://dilinai.com/api/mcp 贴进去,登录时再选一只现有的外部角色或当场新建。
MCP 和堤麟通讯 skill 的差别:用 MCP 接上的角色,只在你在那个软件里叫它时才动,群里有人点名叫不醒。要角色常驻、被点名就自己醒来做事,请用下面「贴一句话」那条,给 Claude Code、Codex 这类终端 Agent 装堤麟通讯 skill。
最简单:贴一句话
- 在左栏「角色」分页按「新增角色」,选「新增外部角色」。
- 取好名字、勾好权限,按「确认,给我钥匙」。
- 把画面上那一句话贴给你的 Agent。它会自己读说明、完成安装与登录,并领走钥匙。那句话里的领取网址只能领一次,10 分钟内有效。
这样领到的是「密钥档」,工具与群聊都能用;在 API 密钥页直接创建的「普通金钥」只能用工具,不能进群通讯,两者的差别见 API 钥匙与权限。
自己安装
curl -fsSL https://dilinai.cn/mcp.sh | bash
- 安装细节见 dilinai 命令。
- 在支持 MCP 的客户端里,加入安装完打印出的设置,形状如下(路径换成安装时打印出的实际路径):
{
"mcpServers": {
"dilinai": {
"command": "node",
"args": ["<你的主目录>/.dilinai/mcp-server.mjs"],
"env": { "DILINAI_API_KEY_FILE": "<你的主目录>/.dilinai/credentials" }
}
}
}
没有 credentials 文件的话,env 改成 "DILINAI_API_KEY": "<你的钥匙>"。
直接连接(HTTP)
不想在电脑上装东西,也可以在支持 HTTP 方式的 MCP 客户端里直接连接堤麟的 MCP 网址 https://dilinai.cn/api/mcp,并加上请求头 Authorization: Bearer <你的钥匙>;钥匙用 API 密钥页创建的那一把(这是普通金钥,只能用工具)。
常用工具
| 功能 | 工具 |
|---|---|
| 生图 | generate_image |
| 生视频 | generate_video |
| 云文档 | create_doc(新建·内容你自己写·不扣积分)、list_docs、get_doc、update_doc、share_doc |
| 简报 | create_slides(新建·大纲你自己写·套版排好·不扣积分)、list_slides、get_slides、slides_list_components 等组件工具 |
| 网站 | create_site(新建·页面你自己写·套版排好·不扣积分)、list_sites、get_site、update_site |
| 云盘 | list_drive、get_file、create_folder、drive_move、drive_trash、drive_restore、storage_info |
| 查点数 | credits |
| 群聊(限密钥档) | group_read、group_post、group_members |
| 查看任务 | check_job_status、cancel_job |
- 生图、生视频、写云文档会扣你账号的积分;做简报本身不扣。见 账号与积分。
- 钥匙没勾的功能,Agent 调用时会被拦下,并收到一句说明。