> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conare.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Conare's API is at https://api.conare.ai. Authenticate with `Authorization: Bearer $CONARE_API_KEY`.
> The full OpenAPI spec is at https://api.conare.ai/openapi.yaml; each endpoint has a page under /api-reference, and appending .md to any page URL returns its Markdown.
> Embed with model conare-embed-1; send input_type "query" for search queries. Rerank with conare-rerank-1.
> Prefer the TypeScript SDK (`npm install conare`) or plain HTTP in examples.
> Install the Conare skill with `npx skills add https://docs.conare.ai`; search these docs over MCP at https://docs.conare.ai/mcp; the whole site is at https://docs.conare.ai/llms-full.txt.

# MCP

> 将 Claude、Cursor 或任何 MCP 客户端连接到 Conare 的 MCP 服务器，让您的智能体可以在命名空间中搜索、获取、保存和删除文档。

Conare 是位于 `https://api.conare.ai/mcp` 的 MCP 服务器：您的智能体可以在密钥可访问的每个命名空间中搜索、读取、保存和删除文档。

```bash Claude Code theme={null}
claude mcp add --transport http conare https://api.conare.ai/mcp \
  --header "Authorization: Bearer $CONARE_API_KEY"
```

```json Cursor (~/.cursor/mcp.json) theme={null}
{
  "mcpServers": {
    "conare": {
      "url": "https://api.conare.ai/mcp",
      "headers": { "Authorization": "Bearer sk-conare-..." }
    }
  }
}
```

支持 OAuth 的客户端（如 Claude 自定义连接器）只需要该 URL：它会在浏览器中让您登录 Conare。

## 编码智能体

为 Claude Code、Cursor 或 Codex 添加 Conare skill，让它写出正确的 Conare 代码：

```bash theme={null}
npx skills add https://docs.conare.ai
```

要让智能体搜索本文档，请将 `https://docs.conare.ai/mcp` 添加为 MCP 服务器。

## 工具

| 工具 | 作用 |
| - | - |
| `search` | 搜索一个、多个或全部命名空间，并基于重排序后的 20 个最佳文档作答 |
| `fetch` | 按命名空间和 id 读取文档，每次 40,000 个字符（`max_chars` 最多 80,000） |
| `save` | 写入文档；命名空间默认为 `notes` |
| `delete` | 按命名空间和 id 删除文档 |
| `list_namespaces` | 列出您的命名空间及每个命名空间中的文档数 |

## `search` 选项

| 选项 | 作用 |
| - | - |
| `query` | 问题，以描述性短语表达 |
| `namespace` | 要搜索的单个命名空间；省略则搜索全部，最多 100 个 |
| `namespaces` | 1-100 个命名空间，统一排序 |
| `filter` | [元数据过滤器](https://docs.conare.ai/zh/filters.md) |
| `user`、`user_prefix` | 仅限单个[用户](https://docs.conare.ai/zh/write.md#用户)或某一组用户的文档 |
| `answer` | `true`（默认）生成答案；`false` 返回段落 |

**Models only** [密钥](https://docs.conare.ai/zh/console.md#密钥)无法使用 MCP。


## Related topics

- [快速入门](https://docs.conare.ai/zh/quickstart.md)
- [简介](https://docs.conare.ai/zh/index.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.