quip MCP

Quip MCP服务器

A. 模型上下文协议（MCP） 服务器为AI助手提供全面的Quip文档访问和管理。


✨ 特性

• 完整文档生命周期：创建、阅读、编辑、删除Quip文档
• 智能搜索：查找具有全面搜索功能的文档
• 最近的文档：访问您最近查看/编辑的文档
• 用户管理：获取用户信息和详细信息
• 评论：检索和管理文档讨论
• Markdown支持：彻底清除标记格式
• 强劲的API：处理复杂的Quip API响应结构
• 安全：具有企业支持的基于令牌的身份验证

🚀 快速安装

步骤1：安装二进制文件

一行安装（macOS/Linux）

curl -sSL https://raw.githubusercontent.com/bug-breeder/quip-mcp/main/install.sh | bash

手动下载

从以下网址下载适用于您平台的二进制文件 发布页面.

步骤2：添加到光标（单击一下）

安装二进制文件后，单击下面的按钮将MCP服务器配置添加到您的Cursor IDE中：


备注：此按钮仅将MCP配置添加到光标。您必须安装 quip-mcp 二进制优先（步骤1）。

⚡ 快速开始

1. 获取您的API代币

- 访问您的Quip实例： https://your-company.quip.com/dev/token - 生成新的API令牌

1. 配置服务器

   quip-mcp --setup

1. 添加到您的MCP客户端

请参阅下面针对您的特定客户的说明。

就是这样！您的AI助手现在可以访问您的Quip文档。

🔌 MCP客户端配置

光标

1. 单击此README顶部的“添加到光标”按钮。

1. 或者，您可以在Cursor的设置中手动添加服务器。首选 File > Settings > MCP 并添加具有以下配置的新服务器：

   {
     "mcpServers": {
       "quip-mcp": {
         "command": "quip-mcp"
       }
     }
   }

克劳德

您可以使用两种方法将Quip MCP服务器添加到Claude：

1.命令行

打开终端并运行以下命令：

claude mcp add quip-mcp -- quip-mcp

2.配置文件

将以下内容直接添加到您的claude桌面应用程序的设置或您的 claude_desktop_config.json 文件：

{
  "mcp_servers": [
    {
      "name": "quip-mcp",
      "command": ["quip-mcp"]
    }
  ]
}

其他客户

对于其他MCP客户端，您通常可以在设置中添加新服务器。使用以下配置：

{
  "mcpServers": {
    "quip-mcp": {
      "command": "quip-mcp"
    }
  }
}

🔄 更新

快速更新

使用一个命令更新到最新版本：

curl -sSL https://raw.githubusercontent.com/bug-breeder/quip-mcp/main/install.sh | bash -s -- --update

更新脚本将：

• ✅ 检查您当前的版本
• ✅ 如果您已经拥有最新版本，则跳过更新
• ✅ 仅在有更新版本可用时安装
• ✅ 保留现有配置

检查当前版本

quip-mcp --version

🛠️ 可用工具

📖 使用示例

获取最近使用的文档

Show my recent Quip documents

搜索文档

Search for documents about "project planning"

读取文档内容

Get the full content of document V9T5AFuROlBN

创建新文档

Create a document titled "Meeting Notes" with markdown content about today's team meeting

编辑现有文档

Add a new section to document ABC123 about next week's goals

删除文档

Delete the test document XYZ789

⚙️ 配置

环境变量

export QUIP_API_TOKEN="your-token-here"
quip-mcp

配置文件

服务器会自动将您的令牌保存到：

• Linux/macOS： ~/.config/quip-mcp/config.yaml
• 窗户： %APPDATA%/quip-mcp/config.yaml

CLI选项

quip-mcp --help          # Show help
quip-mcp --version       # Show version
quip-mcp --setup         # Interactive token setup
quip-mcp --config        # Show current configuration

🏢 公司实例

此服务器可与Quip.com和公司特定实例一起使用：

• Quip.com：标准公共测验
• 公司实例: https://your-company.quip.com

API令牌自动处理到特定实例的路由。

🔒 安全

• 令牌以受限文件权限存储（0600）
• 所有API通信都使用HTTPS
• 未记录敏感数据

🛡️ 故障排除

常见问题

“找不到API令牌”

# Run interactive setup
quip-mcp --setup

# Or set environment variable
export QUIP_API_TOKEN="your-token-here"

“搜索不可用”

• 某些Quip实例已禁用搜索
• 改用直接文档ID
• 从Quip URL中提取文档ID： https://company.quip.com/DOCUMENT_ID/title

“权限被拒绝”

• 确保您的API令牌具有适当的权限
• 在Quip中检查文档访问级别

🔧 发展

从源代码构建

git clone https://github.com/bug-breeder/quip-mcp.git
cd quip-mcp
make build

质量保证工作流程

# Run comprehensive pre-commit checks (recommended before any commit)
make pre-commit

### Testing

Unit tests (mocked)

make test-unit

Integration tests (requires QUIP_API_TOKEN)

export QUIP_API_TOKEN="your-token" make test-integration

Run all tests

make test-all

### 开发工具

make help # Show all available commands make dev-setup # Install development dependencies make coverage # Generate test coverage report

## 📄 许可证

MIT许可证-请参阅 [许可证](LICENSE) 文件以获取详细信息。

## 🤝 贡献

欢迎投稿！请随时提交问题和拉取请求。