让 AI 直接查你站里的索引：Meilisearch 内置 MCP 怎么用，边界在哪

这回省掉的是自己写那一层

以前要让 AI 用你自己的数据，路子无非两种：自己包一层检索接口，或者装个社区维护的本地 stdio 小服务。Meilisearch 把 MCP 服务端直接做进了产品本体——实例上就挂着一个 POST /mcp，任何支持远程 HTTP MCP 的客户端连上去就能检索你的索引。官方同时把老的 meilisearch-mcp 这个 Python 包标为 deprecated、不再维护，自建中间层这一步可以省了。

四个工具，全是只读

listIndexes、describeIndex、searchInIndexes、facetSearch。前两个是让模型先看清你有什么：列出索引、取最多 5 条样本文档（注意 describeIndex 不返回索引设置和 embedder 配置）。searchInIndexes 走的是 multi-search，query、filter、sort、facets、混合搜索、联邦结果都能带进去。

写操作一个都没有：建索引、改文档、改设置、管 API key、查任务和健康状态，全都不在这个 MCP 里，得走 API 或云控制台。我倒觉得这是优点——AI 只能搜，改数据还走你自己的应用，出错面小得多。

开通就三步

1. 版本要 v1.54 及以上，并且 MCP 路由目前属于实验功能，得先打开实验特性开关；没开时 /mcp 直接返回 feature_not_enabled。
2. 建一把专用 API key，动作给 indexes.get、documents.get、search，并且限定到允许它查的那几个索引。默认的 Search key 没有前两个权限，listIndexes 和 describeIndex 会失败。
3. 在客户端注册 https://你的域名/mcp，把 key 当 Bearer token 放进 Authorization 头。没有 OAuth，key 就是唯一凭据——所以它必须是专用、可随时吊销的那把。

Claude Code、Codex、Cursor 三种客户端官方都给了配置写法，前两个是 URL 加 header，Codex 是配置文件里的一段。

什么人真的用得上

已经自建搜索、又想让 AI 拿自己的内容回答问题的站点：文档站、商品库、内容站、内部知识库。文档里把语义搜索、RAG 对话、相似文档检索和给人用的搜索框并列放在一起，一个索引两头用，这比单独再搭一套向量库划算。

风险清单

• 实验功能，接口可能变，别把关键业务压在上面。
• 只读既是盾牌也是天花板：想让 agent 写数据，得自己在应用里开接口。
• key 泄露基本等于索引对公网可读，按最小权限建、定期轮换。
• 自托管的升级、备份、内存都是你自己的活；索引大了别跟数据库抢同一台小机器。
• 分片和 S3 流式快照属于 Enterprise Edition，社区版（MIT）没有，也就不必为以后可能要分片提前付费。

先把一个只读索引喂给 agent，比先做一整套 agent 靠谱。