129 lines
4.7 KiB
Markdown
129 lines
4.7 KiB
Markdown
|
# Claude多源上下文检索插件
|
|||
|
|
|
|||
|
|
`Claude插件` `上下文检索` `MCP` `语义搜索` `多源集成`
|
|||
|
|
|
|||
|
|
# 适用于 Claude 的 Airweave 插件
|
|||
|
|
Airweave 官方 Claude Code 和 Cowork 插件。
|
|||
|
|
|
|||
|
|
Airweave 是 Claude 与你的应用（如 Notion、Slack、Google Drive、Linear、Jira、GitHub 和 Salesforce）之间的上下文检索层。直接从 Claude Code 和 Cowork 中搜索你的应用。Airweave 持续同步并索引来自 40 余个数据源的数据，构建统一的可搜索集合，支持智能体搜索、语义搜索和关键词搜索。
|
|||
|
|
|
|||
|
|
## 安装
|
|||
|
|
|
|||
|
|
### 从 Claude Code 安装
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
claude plugin install airweave
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 手动安装
|
|||
|
|
|
|||
|
|
克隆并安装插件：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
git clone https://github.com/airweave-ai/claude-plugin
|
|||
|
|
claude --plugin-dir ./claude-plugin
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 配置
|
|||
|
|
|
|||
|
|
安装完成后，设置你的 Airweave 凭据：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
export AIRWEAVE_API_KEY="your-api-key"
|
|||
|
|
export AIRWEAVE_COLLECTION="your-collection-id"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
从 Airweave 控制台获取 API 密钥：
|
|||
|
|
|
|||
|
|
- Airweave Cloud 用户访问 [app.airweave.ai](https://app.airweave.ai)
|
|||
|
|
- 本地部署用户，将 base_url 设置为 `http://localhost:8001`
|
|||
|
|
|
|||
|
|
从控制台的集合视图中获取你的 Airweave Collection ID，或通过列出集合并获取目标集合的 `readable_id`：
|
|||
|
|
|
|||
|
|
```typescript
|
|||
|
|
import { AirweaveSDKClient } from "@airweave/sdk";
|
|||
|
|
|
|||
|
|
const client = new AirweaveSDKClient({ apiKey: "YOUR_AIRWEAVE_API_KEY" });
|
|||
|
|
await client.collections.list({
|
|||
|
|
skip: 0,
|
|||
|
|
limit: 100
|
|||
|
|
});
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 前置条件
|
|||
|
|
|
|||
|
|
- [Airweave 账号](https://app.airweave.ai)（云端）或[自托管实例](https://github.com/airweave-ai/airweave)
|
|||
|
|
- 至少一个已连接数据源的集合
|
|||
|
|
|
|||
|
|
## 功能特性
|
|||
|
|
|
|||
|
|
本插件提供一个 MCP 服务器和两个技能，用于与 Airweave 协同工作：
|
|||
|
|
|
|||
|
|
- **跨应用搜索** — 通过单一界面查询 Slack、GitHub、Notion、Jira、Google Drive、Salesforce 及 40 余个其他数据源
|
|||
|
|
- **三种搜索模式** — 即时模式（快速向量搜索）、经典模式（AI 优化搜索方案）和智能体模式（对数据进行迭代推理）
|
|||
|
|
- **智能模式选择** — Claude 根据查询复杂度自动选择合适的搜索模式
|
|||
|
|
- **丰富的结果展示** — 结构化结果，包含面包屑导航、来源元数据、相关性评分及返回源应用的直达链接
|
|||
|
|
|
|||
|
|
## 技能
|
|||
|
|
|
|||
|
|
技能根据上下文自动触发：
|
|||
|
|
|
|||
|
|
| 技能 | 触发场景 |
|
|||
|
|
|------|---------|
|
|||
|
|
| `airweave-search` | "查找关于……的消息"、"在我的文档中搜索……"、"团队讨论了什么……" |
|
|||
|
|
| `airweave-setup` | "设置 Airweave"、"将 Slack 连接到 Airweave"、"安装 Airweave SDK" |
|
|||
|
|
|
|||
|
|
### airweave-search
|
|||
|
|
|
|||
|
|
帮助 Claude 从已连接的数据源中搜索和检索上下文。处理查询构建、参数选择、结果解读，以及在结果不佳时进行优化。
|
|||
|
|
|
|||
|
|
### airweave-setup
|
|||
|
|
|
|||
|
|
引导开发者完成 Airweave 安装、创建集合、连接数据源，以及将 SDK（Python/TypeScript）或 MCP 服务器集成到其应用中。
|
|||
|
|
|
|||
|
|
## 使用示例
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
> Slack 中团队关于产品发布讨论了什么？这与 Linear 和 Notion 中的项目状态是否一致？
|
|||
|
|
Claude 搜索已连接的 Slack、Linear 和 Notion 工作区，并汇总相关消息。
|
|||
|
|
|
|||
|
|
> 查找我们身份认证服务的 API 规范
|
|||
|
|
Claude 跨 GitHub 仓库、Confluence 文档和 Jira 工单搜索实现上下文。
|
|||
|
|
|
|||
|
|
> 我们目前的退款政策是什么？最近一次更新是什么时候？
|
|||
|
|
Claude 搜索公司 Wiki、Google Drive、Jira 和 Stripe，找到权威文档。
|
|||
|
|
|
|||
|
|
> 检查 Jira、Stripe 和 GitHub 中与支付相关的未解决 Bug
|
|||
|
|
Claude 查询你的 Jira 项目，汇总未解决问题。
|
|||
|
|
|
|||
|
|
> 在 Finance 技术栈中搜索 Q4 董事会报告
|
|||
|
|
Claude 使用语义搜索在共享云盘和 Salesforce 中定位文件。
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 支持的数据源
|
|||
|
|
|
|||
|
|
Airweave 连接 [40 余个数据源](https://docs.airweave.ai/connectors/overview)，包括：
|
|||
|
|
|
|||
|
|
| 类别 | 数据源 |
|
|||
|
|
|------|--------|
|
|||
|
|
| 效率与协作 | Asana、Airtable、ClickUp、Linear、Monday、Notion、Trello、Todoist |
|
|||
|
|
| 云存储与文档 | Box、Dropbox、Google Docs、Google Drive、Google Slides、OneDrive、OneNote、SharePoint、Word |
|
|||
|
|
| 开发者工具 | Confluence、Bitbucket、GitHub、GitLab、Jira |
|
|||
|
|
| CRM 与销售 | Attio、HubSpot、Pipedrive、Salesforce、Zoho CRM |
|
|||
|
|
| 通信与邮件 | Gmail、Google Calendar、Outlook Calendar、Outlook Mail、Slack、Teams |
|
|||
|
|
| 支持与服务 | Zendesk |
|
|||
|
|
| 数据库 | PostgreSQL |
|
|||
|
|
| 电商与支付 | Shopify、Stripe |
|
|||
|
|
|
|||
|
|
完整列表请访问 [docs.airweave.ai/connectors/overview](https://docs.airweave.ai/connectors/overview)。
|
|||
|
|
|
|||
|
|
## 文档
|
|||
|
|
|
|||
|
|
- [Airweave 文档](https://docs.airweave.ai)
|
|||
|
|
- [Airweave Cloud](https://app.airweave.ai)
|
|||
|
|
- [GitHub](https://github.com/airweave-ai/airweave)
|
|||
|
|
- [Discord](https://discord.gg/484HY9Ehxt)
|
|||
|
|
|
|||
|
|
## 许可证
|
|||
|
|
|
|||
|
|
MIT
|