内容
# Taplio LinkedIn MCP 服务器
[](./LICENSE)
[](https://modelcontextprotocol.io)
[-brightgreen.svg)](#remote-taplio-mcp-server)
Taplio LinkedIn MCP 服务器是一款 [模型上下文协议（MCP）](https://modelcontextprotocol.io/introduction) 服务器，它直接将 AI 工具连接到您的 [Taplio](https://taplio.com) 账户，并通过它连接到您的 LinkedIn 存在。它使 AI 代理、助手和聊天客户端能够起草、安排和发布 LinkedIn 帖子，浏览您已经发布的帖子，从其他创作者研究灵感，并读取您的分析数据，所有这些都通过自然语言。
指向 Taplio 服务器的 MCP 主机，您可以提出以下问题：
- “为我们的新 MCP 启动创建一个 LinkedIn 帖子，并安排在星期二 9 点发布。”
- “显示我的最后 10 篇帖子，哪一篇的印象最多。”
- “找到 20 篇关于 `linkedin ghostwriting` 的高绩效帖子，来自关注者少于 50k 的创作者。”
- “我的关注者和参与度在过去 30 天内如何趋势变化？”
## 用例
- 将原始想法转化为可发布的 LinkedIn 帖子，以您自己的声音和主题。
- 从任何支持 MCP 的客户端自动创建、安排和发布草稿。
- 在您的真实 LinkedIn 数据之上构建 AI 辅助内容工作流和报告。
- 在不离开您的助手的情况下，从您的发布历史中提取见解和分析数据。
---
## 目录
- [远程 Taplio MCP 服务器](#remote-taplio-mcp-server)
- [前提条件](#prerequisites)
- [安装](#installation)
- [Claude 代码](#claude-code)
- [Claude 桌面版 / claude.ai 连接器](#claude-desktop--claudeai-connectors)
- [VS 代码](#vs-code)
- [Cursor](#cursor)
- [Windsurf](#windsurf)
- [通用 MCP 配置](#generic-mcp-config)
- [身份验证](#authentication)
- [工具集](#toolsets)
- [工具](#tools)
- [个人资料](#profile)
- [草稿](#drafts)
- [发布](#publishing)
- [帖子](#posts)
- [分析](#analytics)
- [灵感](#inspiration)
- [推荐的工作流程](#recommended-workflow)
- [库和生命周期模型](#library-and-lifecycle-model)
- [限制和安全](#limits-and-safety)
- [故障排除](#troubleshooting)
- [贡献](#contributing)
- [许可证](#license)
---
## 远程 Taplio MCP 服务器
Taplio 作为托管的远程 MCP 服务器提供。无需本地安装或运行：您的 MCP 主机通过 HTTP 连接到 Taplio 端点并使用 OAuth 进行身份验证。
| 属性 | 值 |
| --- | --- |
| 传输 | 可流式 HTTP（远程） |
| 端点 | `https://mcp.taplio.com` |
| 身份验证 | OAuth 2.0（在浏览器中授权，无需粘贴 API 密钥） |
| 范围 | 已验证用户自己的 Taplio + LinkedIn 账户 |
| 服务器提示 | 首先调用 [`get_me`](#get_me) 以加载身份和设置 |
> 由于服务器是远程的并且基于 OAuth，您永远不会将密钥复制到配置文件中。访问权限与您在浏览器中批准的 Taplio 账户绑定，并且可以随时在 Taplio 中撤销。
---
## 先决条件
1. 一个活跃的 [Taplio](https://taplio.com) 账户，LinkedIn 已连接。
2. 一个支持 MCP 的主机（Claude Code、Claude Desktop、带有 Copilot 的 VS Code、Cursor、Windsurf 或任何通过 HTTP 支持 MCP 的客户端）。
3. 在首次连接时需要一个可用的浏览器，以完成 OAuth 授权。
---
## 安装
### Claude 代码
```bash
claude mcp add --transport http taplio https://mcp.taplio.com
```
然后在 Claude Code 中运行 `/mcp` 并在提示时在浏览器中授权 `taplio`。
### Claude 桌面版 / claude.ai 连接器
在 Claude 桌面版或 claude.ai 中，打开 **设置 -> 连接器 -> 添加自定义连接器**，然后输入：
- **名称：** `Taplio`
- **网址：** `https://mcp.taplio.com`
批准 OAuth 屏幕。然后，Taplio 工具将出现在工具选择器中。
### VS 代码
将以下内容添加到您的用户或工作区 MCP 配置（`.vscode/mcp.json`）：
```json
{
"servers": {
"taplio": {
"type": "http",
"url": "https://mcp.taplio.com"
}
}
}
```
### Cursor
在 `~/.cursor/mcp.json`（或 **设置 -> MCP -> 添加**）：
```json
{
"mcpServers": {
"taplio": {
"url": "https://mcp.taplio.com"
}
}
}
```
### Windsurf
在 `~/.codeium/windsurf/mcp_config.json` 中：
```json
{
"mcpServers": {
"taplio": {
"serverUrl": "https://mcp.taplio.com"
}
}
}
```
### 通用 MCP 配置
任何支持通过 HTTP 的远程 MCP 服务器的客户端都可以使用：
```json
{
"mcpServers": {
"taplio": {
"type": "http",
"url": "https://mcp.taplio.com"
}
}
}
```
---
## 身份验证
Taplio MCP 服务器使用 OAuth 2.0。首次使用时，您的客户端会打开一个浏览器窗口，您在其中登录到 Taplio 并批准访问权限。然后，服务器代表该单个账户执行操作。无需存储 API 密钥、令牌或 LinkedIn 凭证。在 Taplio 账户设置中可以随时撤销访问权限。
---
## 工具集
工具分为功能性工具集。所有工具都对已验证用户自己的账户进行操作。
| 工具集 | 描述 |
| --- | --- |
| **个人资料** | 身份、内容偏好和当前 LinkedIn 统计数据。 |
| **草稿** | 创建、读取、列出、编辑和删除未发布的帖子草稿。 |
| **发布** | 立即发布草稿、安排或取消安排。 |
| **帖子** | 浏览已安排、发送和已发送的帖子。 |
| **分析** | 账户级概览和每篇帖子的性能指标。 |
| **灵感** | 搜索其他创作者的 LinkedIn 帖子以作为灵感。 |
---
## 工具
### 个人资料
#### `get_me`
首先读取此内容以定位。返回用户的身份和内容偏好，以便您可以根据他们的偏好定制输出并识别他们自己的帖子：显示名称和 LinkedIn `@handle`（用户可能有多个别名，因此请检查两者），以及 `ai_settings`（行业、角色、语言、目标受众、主题、关键词、描述）和当天的 LinkedIn 统计数据（关注者、连接数、个人资料浏览量）。
_无参数。_
---
### 草稿
#### `create_draft`
创建一个新的 LinkedIn 帖子草稿（未发布）。稍后可以使用 `schedule_draft` 或 `publish_draft` 发布。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `content` | 字符串 | 是 | 草稿的文本正文。1 到 3000 个字符。 |
#### `get_draft`
通过 ID 获取单个 LinkedIn 帖子草稿。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `id` | 字符串 | 是 | 草稿的 ID（来自 `list_drafts`）。 |
#### `list_drafts`
列出用户未发布的 LinkedIn 帖子草稿。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `limit` | 整数 | 否 | 返回的最大草稿数。默认为 25，最高 100。 |
| `cursor` | 字符串 | 否 | 前一个响应的分页令牌。 |
#### `update_draft`
更新现有草稿的内容。只有草稿可以编辑：已发布或已安排的帖子不能编辑。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `id` | 字符串 | 是 | 要更新的草稿的 ID（来自 `list_drafts`）。 |
| `content` | 字符串 | 是 | 新的全文正文（替换现有内容）。1 到 3000 个字符。 |
#### `delete_draft`
永久删除 LinkedIn 帖子草稿。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `id` | 字符串 | 是 | 要永久删除的草稿的 ID。 |
---
### 发布
#### `publish_draft`
立即发布草稿到 LinkedIn。这样会立即生效，无法撤销。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `id` | 字符串 | 是 | 要立即发布的草稿的 ID。 |
#### `schedule_draft`
安排草稿在未来某个时间自动发布。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `id` | 字符串 | 是 | 要安排的草稿的 ID（来自 `list_drafts`）。 |
| `scheduled_for` | 字符串 | 是 | ISO 8601 日期时间（例如 `2026-06-10T14:30:00Z`）。至少在未来 2 分钟。 |
#### `unschedule`
取消安排已安排的帖子，返回草稿，以便您可以编辑、重新安排或删除它。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `id` | 字符串 | 是 | 已安排的帖子的 ID（来自 `list_posts`）。 |
---
### 帖子
#### `list_posts`
列出用户的 LinkedIn 帖子（状态为 `scheduled`、`sending` 或 `sent`），最近的优先。草稿一旦安排或发布就变成帖子。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `status` | 枚举 | 否 | 按 `scheduled`、`sending` 或 `sent` 过滤。省略则显示所有三种状态。 |
| `from` | 字符串 | 否 | 仅限于此日期之后的帖子（YYYY-MM-DD 或 ISO 8601，UTC）。 |
| `to` | 字符串 | 否 | 仅限于此日期之前的帖子（YYYY-MM-DD 或 ISO 8601，UTC）。 |
| `limit` | 整数 | 否 | 返回的最大帖子数。默认为 25，最高 100。 |
| `cursor` | 字符串 | 否 | 前一个响应的分页令牌。 |
#### `get_post`
通过 ID 获取单个 LinkedIn 帖子。帖子状态为 `scheduled`、`sending` 或 `sent`；草稿是分开的（使用 `get_draft`）。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `id` | 字符串 | 是 | 帖子的 ID（来自 `list_posts`）。 |
---
### 分析
#### `get_analytics_overview`
获取用户的 LinkedIn 分析概览（关注者、印象、参与度）。如果未指定日期范围，则默认为今日。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `from` | 字符串 | 否 | 开始日期（YYYY-MM-DD，UTC）。默认为今日；范围上限 90 天。 |
| `to` | 字符串 | 否 | 结束日期（YYYY-MM-DD，UTC）。默认为今日；范围上限 90 天。 |
| `metrics` | 字符串 | 否 | 以逗号分隔的子集：`followers, connections, profile_views, impressions, likes, comments, shares`。省略则显示所有。 |
| `granularity` | 枚举 | 否 | 时间桶大小；仅支持 `day`（默认）。 |
#### `get_post_analytics`
列出用户的每篇帖子分析数据（印象、点赞、评论、分享），默认显示最近 7 天。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `from` | 字符串 | 否 | 开始日期（YYYY-MM-DD，UTC）。默认为 7 天前；范围上限 90 天。 |
| `to` | 字符串 | 否 | 结束日期（YYYY-MM-DD，UTC）。默认为今日；范围上限 90 天。 |
| `limit` | 整数 | 否 | 返回的最大帖子数。默认为 25，最高 100。 |
| `cursor` | 字符串 | 否 | 前一个响应的分页令牌。 |
---
### 灵感
#### `search_inspiration`
搜索其他创作者的 LinkedIn 帖子作为灵感。
| 参数 | 类型 | 必需 | 描述 |
| --- | --- | --- | --- |
| `query` | 字符串 | 否 | 对帖子内容的自由文本搜索。省略则浏览热门帖子。 |
| `lang` | 字符串 | 否 | 按 ISO 639-1 语言代码过滤（例如 `en`、`fr`）。 |
| `min_likes` | 整数 | 否 | 仅限点赞数至少为此数的帖子。0-1000；默认为 50。 |
| `min_comments` | 整数 | 否 | 仅限评论数至少为此数的帖子。0-1000；默认为 0。 |
| `min_char_count` | 整数 | 否 | 仅限字符数至少为此数的帖子。0-10000；默认为 500。 |
| `max_followers` | 整数 | 否 | 仅限作者关注者数最多为此数的帖子。默认为 100000。 |
| `min_days_old` | 整数 | 否 | 仅限发布时间至少为 N 天的帖子（0-365）；默认为 1。覆盖 `from`/`to`。 |
| `max_days_old` | 整数 | 否 | 仅限最近 N 天内的帖子（0-365）。覆盖 `from`/`to`。 |
| `from` | 字符串 | 否 | 仅限此日期之后的帖子。忽略如果设置了 `min`/`max_days_old`。 |
| `to` | 字符串 | 否 | 仅限此日期之前的帖子。忽略如果设置了 `min`/`max_days_old`。 |
| `limit` | 整数 | 否 | 返回的最大帖子数。最小 1；默认为 30。 |
---
## 推荐的工作流程
1. 调用 [`get_me`](#get_me) 以加载用户的声音、主题、语言和统计数据。
2. 使用 [`search_inspiration`](#search_inspiration) 以当前有效的帖子为基础进行内容创作。
3. 使用 [`create_draft`](#create_draft) 创建草稿，使用 [`update_draft`](#update_draft) 进行迭代。
4. 使用 [`schedule_draft`](#schedule_draft)（推荐）或 [`publish_draft`](#publish_draft)（立即）发布。
5. 使用 [`get_analytics_overview`](#get_analytics_overview) 和 [`get_post_analytics`](#get_post_analytics) 报告，并与 [`list_posts`](#list_posts) 进行交叉验证。
---
## 库和生命周期模型
**草稿** 和 **帖子** 是同一项目在不同生命周期阶段的相同项目：
```
create_draft ─┐
├─> [ 草稿 ] ──schedule_draft──> [ 已安排 ] ──(自动)──> [ 发送 ] ──> [ 已发送 ]
update_draft ─┘ │ │
└──────publish_draft───────────┴──(立即)──> [ 发送 ] ──> [ 已发送 ]
[ 已安排 ] ──unschedule──> [ 草稿 ]
```
- 草稿存在于 **草稿** 列表（`list_drafts`）中，是唯一可编辑的阶段。
- 安排或发布草稿会将其变成 **帖子** 并将其移至 **帖子** 列表（`list_posts`）。
- `unschedule` 将已安排的帖子移回草稿；`sent` 帖子无法取消发送。
---
## 限制和安全
- **帖子长度：** 1 到 3000 个字符（`create_draft`、`update_draft`）。
- **安排：`scheduled_for` 必须至少在未来 2 分钟，推荐使用 ISO 8601，UTC。
- **分析范围：** 每个查询上限 90 天；对于大结果集，请使用 `cursor` 进行分页。
- **不可逆操作：** `publish_draft` 立即生效且无法撤销，且 `delete_draft` 是永久的。在调用任一操作前请确认意图。
- **范围：** 每个工具仅对已验证用户的自己的 Taplio 和 LinkedIn 账户生效。
---
## 故障排除
- **工具未显示：** 确认服务器 URL 为 `https://mcp.taplio.com` 并且您已完成 OAuth 浏览器步骤。重新运行 `/mcp`（Claude Code）或重新连接连接器。
- **401 / 身份验证错误：** 您的会话可能已过期或被撤销。在浏览器中重新连接并重新授权。
- **无法编辑帖子：** 只有草稿是可编辑的。如果已经安排，请先调用 `unschedule`；如果已发送，则无法更改。
- **空分析：** 新发布的帖子需要时间积累指标；同时检查您的日期范围是否符合 90 天上限。
---
## 贡献
本仓库记录了 Taplio LinkedIn MCP 服务器。参见 [CONTRIBUTING.md](./CONTRIBUTING.md) 报告文档问题或建议改进。对于产品支持，请联系 Taplio。
---
## 许可证
该项目根据 MIT 许可证条款授权。参见 [LICENSE](./LICENSE)。
