ものしりAI
使用指南

从Claude、Gemini、Codex连接Monoshiri AI -- MCP集成指南【2026年版】

2026年4月20日Monoshiri AI 编辑部

从Claude、Gemini、Codex连接Monoshiri AI MCP集成指南

你是否曾想过,直接在常用的AI工具中查询企业内部知识

Monoshiri AI支持MCP(Model Context Protocol,模型上下文协议),可以从Claude Desktop、Claude.ai、Gemini CLI、Codex、Dify、Cursor等支持MCP的AI客户端直接连接Monoshiri AI的知识库

本文将详细介绍如何从各个工具连接Monoshiri AI。


本文要点

  • 什么是MCP(模型上下文协议)
  • Monoshiri AI提供的4项MCP功能
  • 如何从Claude Desktop / Claude.ai / Claude Code / Gemini CLI / Codex / Dify / Cursor进行连接
  • 安全性与权限管理

什么是MCP

MCP(Model Context Protocol,模型上下文协议)是一种让AI助手连接外部数据源和工具的开放标准协议。由Anthropic公司提出,截至2026年,Claude、Gemini CLI、Codex等主流AI工具均已支持。

通过MCP,你只需在日常AI对话中问一句"帮我查一下公司的考勤制度",就能从Monoshiri AI的知识库中检索信息并生成回答。无需切换AI工具,不会打断你的工作节奏


Monoshiri AI提供的4项MCP工具

Monoshiri AI的MCP服务器提供以下4项工具(操作):

工具名称 功能说明
list_folders 获取你有权访问的文件夹列表
list_documents 获取指定文件夹中的文档列表
search 使用自然语言跨知识库搜索(向量搜索)
get_document 获取文档的详细信息和正文内容

其中search工具最为核心——输入"年假申请流程"之类的自然语言问题,系统会通过向量搜索(语义搜索)从已上传的文档中检索相关信息,再由AI生成回答。


前提条件

  • 拥有Monoshiri AI账户
  • 团队管理员(admin)已启用MCP集成功能
  • MCP连接为只读模式mcp:read范围),无法添加或删除文档

连接方法

Monoshiri AI的MCP服务器URL如下:

https://api.monoshiri.ai/mcp

认证方式支持OAuth 2.1(推荐)或API密钥。使用OAuth连接时,浏览器会自动打开Monoshiri AI的登录页面,授权即可完成连接。


1. Claude Desktop(Anthropic)

Claude Desktop是Anthropic公司的桌面应用程序。

配置步骤:

  1. 打开以下配置文件(如不存在则新建):

    • macOS~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows%APPDATA%\Claude\claude_desktop_config.json
  2. 添加以下内容:

{
  "mcpServers": {
    "monoshiri": {
      "url": "https://api.monoshiri.ai/mcp",
      "transport": "streamable-http"
    }
  }
}
  1. 重启Claude Desktop,浏览器会自动打开Monoshiri AI的OAuth授权页面
  2. 点击**"允许"**即可完成连接

连接成功后,在Claude聊天中输入"帮我查一下公司的XX制度",就能从Monoshiri AI的知识库获取回答。


2. Claude.ai(Web版)

Claude.ai网页版中,也可以作为自定义连接器接入。

配置步骤:

  1. 登录Claude.ai
  2. 进入Settings > Connectors > Add custom connector
  3. Server URL中输入https://api.monoshiri.ai/mcp
  4. 点击Connect按钮,OAuth授权页面会自动打开
  5. 点击**"允许"**即可完成连接

全程在浏览器中完成,无需安装任何应用


3. Claude Code(CLI)

Claude Code是在终端中运行的AI编程代理。

配置步骤:

在Claude Code的配置文件(~/.claude/settings.json或项目根目录下的.claude/settings.json)中添加:

{
  "mcpServers": {
    "monoshiri": {
      "url": "https://api.monoshiri.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

或者通过CLI直接添加:

claude mcp add monoshiri --transport streamable-http --url https://api.monoshiri.ai/mcp

开发过程中,可以直接在终端提问:"帮我确认一下这个功能的需求文档"、"搜索历史故障处理报告"等。


4. Gemini CLI(Google)

Gemini CLI是Google推出的终端AI代理,已支持MCP服务器。

配置步骤:

在Gemini CLI的配置文件(~/.gemini/settings.json)中添加:

{
  "mcpServers": {
    "monoshiri": {
      "url": "https://api.monoshiri.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

参考:Gemini CLI MCP配置文档


5. Codex CLI(OpenAI)

Codex CLI是OpenAI推出的终端AI代理,已支持MCP,可连接Streamable HTTP服务器。

配置步骤:

通过CLI添加:

codex mcp add monoshiri --transport streamable-http --url https://api.monoshiri.ai/mcp

或在配置文件(~/.codex/config.toml或项目根目录下的.codex/config.toml)中添加:

[mcp_servers.monoshiri]
type = "url"
url = "https://api.monoshiri.ai/mcp"
transport = "streamable-http"

参考:Codex MCP配置文档


6. Dify

Dify是一个开源AI应用开发平台。从v1.6.0起原生支持MCP,可将MCP服务器作为工具使用。

配置步骤:

  1. 在Dify管理界面中选择Tools > MCP
  2. 点击Add Server
  3. Server URL中输入https://api.monoshiri.ai/mcp
  4. 配置认证信息(使用API密钥)
  5. 保存后,即可在Dify的工作流和代理中使用Monoshiri AI的搜索工具

通过Dify连接Monoshiri AI,可以零代码构建基于企业知识库的自定义AI代理


7. Cursor(IDE)

Cursor是一款AI驱动的代码编辑器,已支持MCP服务器。

配置步骤:

在项目根目录创建.cursor/mcp.json,或在用户配置~/.cursor/mcp.json中添加:

{
  "mcpServers": {
    "monoshiri": {
      "url": "https://api.monoshiri.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

在Cursor中编写代码的同时,可以直接在编辑器内提问:"帮我确认需求文档中的要求"、"搜索公司的API设计规范"等。


连接测试:MCP Inspector

如果连接遇到问题,可以使用MCP Inspector进行排查。

npx @modelcontextprotocol/inspector

启动后:

  1. Transport:选择"Streamable HTTP"
  2. URL:输入https://api.monoshiri.ai/mcp
  3. 点击Connect按钮启动OAuth流程

连接成功后,会显示list_folderslist_documentssearchget_document四个工具。


安全性与权限管理

认证方式

方式 适用场景 有效期
OAuth 2.1(推荐) Claude Desktop / Claude.ai / Cursor等 访问令牌15分钟,刷新令牌最长60天
API密钥 CI/脚本 / Dify等 管理员手动撤销前一直有效

访问范围

  • MCP为只读模式mcp:read范围)
  • 仅搜索用户有权访问的文件夹
  • 文件夹级别的访问控制在MCP连接中同样有效
  • 无法通过MCP添加、删除或修改文档

管理员控制

  • 团队管理员(admin)可启用/禁用整个MCP集成功能
  • 禁用后,所有成员的MCP连接将立即断开
  • API密钥的签发和撤销仅限管理员操作

应用场景

场景 使用方式
开发中确认需求 在Claude Code / Cursor / Codex中提问"帮我确认这个功能的需求文档"
会议中查阅信息 在Claude.ai中提问"上次会议纪要中的决议事项是什么?"
构建自定义AI代理 在Dify中创建集成Monoshiri AI搜索功能的工作流
日常业务咨询 在Claude Desktop中提问"报销流程是怎样的?"
代码审查 在Cursor中提问"检查一下是否符合公司的编码规范"

总结

通过Monoshiri AI的MCP集成,你可以在常用的AI工具中直接查询企业内部知识

  • Claude Desktop / Claude.ai / Claude Code:只需在JSON配置文件中添加3行即可连接
  • Gemini CLI:支持从Google终端AI工具连接
  • Codex CLI:支持从OpenAI编程代理连接
  • Dify:零代码构建自定义AI代理
  • Cursor:在AI编辑器中边写代码边查阅需求文档
  • 安全性:符合OAuth 2.1标准,只读模式,文件夹级别的访问控制

无需切换AI工具,在日常工作流程中直接访问企业知识库——这就是MCP集成的最大价值。

MCP连接的配置方法也可以在Monoshiri AI管理后台的账户设置页面中查看。

相关文章

免费试用 Monoshiri AI

只需上传文档,即可开始向AI提问。免费计划,用户数无限制。

免费开始

无需信用卡 / 1分钟即可开始