aidelly

Aidelly Claude Code 插件

直接通过 Claude Code 自动管理 Aidelly 社交媒体。在所有已连接的平台上，借助 AI 驱动的 MCP 工具创建、排期和管理帖子。

功能

• 创建和排期帖子 – 在多个平台上立即发布或安排稍后发布
• 审批工作流 – 发布前要求审批并管理帖子审批
• 分析 – 获取互动指标和表现最佳的内容
• 多平台支持 – Instagram、Facebook、LinkedIn、Twitter/X、TikTok、YouTube、Pinterest、Bluesky、Threads、Mastodon、Google Business
• 媒体上传 – 直接获取并上传图片/视频

安装

一键登录。 Aidelly MCP 服务支持 OAuth 2.1、PKCE 和动态客户端注册。Claude 会引导你完成 Aidelly 登录和授权页面，因此无需复制密钥或工作区 ID，插件也绝不会读取你设备上的凭据。

通过 Claude Code 插件市场安装

/plugin marketplace add Aidelly/claude-plugin

然后登录 Aidelly（参见下方的设置）。

手动安装（开发）

克隆此仓库，并将 Claude Code 指向本地插件路径：

git clone https://github.com/Aidelly/claude-plugin
cd claude-plugin
# Add to Claude Code plugin settings

注意： 确保 .mcp.json 已提交到你的本地克隆中。Aidelly monorepo 会忽略 *.mcp.json 文件，因此公开的 Aidelly/claude-plugin 仓库会显式提交该文件。如果克隆后发现缺少 .mcp.json，请运行 git check-ignore .mcp.json — 如果没有输出，则表示该文件已正确提交。

设置

1. 登录

Claude 首次使用 Aidelly 工具时，Claude Code 会提示你登录：

1. 在 Claude Code 中运行 /mcp 并选择 aidelly → Authenticate（或直接提出任何 Aidelly 请求）。
2. 浏览器会打开 Aidelly 登录和授权页面。登录并批准访问。
3. 返回 Claude Code。服务将显示为已连接。

登录需要使用包含 API 访问权限的 Aidelly 方案。令牌会签发给你的账户并在到期后失效；到期后，请从 /mcp 再次登录。

2. 选择工作区

如果你管理多个工作区，请让 Claude 列出它们（aidelly_list_workspaces），并说明要使用哪个工作区。Claude 会将工作区传递给每个工具，因此无需进行任何配置。

3. 验证连接

在 Claude Code 中运行：

List my Aidelly workspaces and connected accounts.

Claude 应返回你的工作区数据。

使用方法

创建帖子

Create a new post on Instagram with the text "Hello world!" and upload media.

排期发布帖子

Schedule a post for tomorrow at 2 PM with approval required.

查看待审批事项

List all posts waiting for approval and approve the first one.

获取分析数据

Get the top 10 posts from the last 30 days and their engagement metrics.

技能文档

完整的端点参考和示例：skills/aidelly-social/SKILL.md

配置

.mcp.json

该插件通过可流式传输的 HTTP 连接到 Aidelly 的远程 MCP 服务。无需设置标头或环境变量；登录由 OAuth 处理：

{
  "mcpServers": {
    "aidelly": {
      "type": "http",
      "url": "https://app.aidelly.ai/api/mcp/public-api"
    }
  }
}

plugin.json

Claude Code 插件目录的元数据：

{
  "name": "aidelly",
  "description": "Aidelly social content automation for Claude Code — create posts, schedule content, check approvals, and pull analytics.",
  "author": { "name": "Aidelly", "url": "https://aidelly.ai" },
  "homepage": "https://aidelly.ai",
  "repository": "https://github.com/Aidelly/claude-plugin",
  "privacyPolicyUrl": "https://www.aidelly.ai/privacy-policy",
  "icon": "./assets/icon.png",
  "version": "0.2.2"
}

故障排除

“Unauthorized”错误

• 运行 /mcp，选择 aidelly → Authenticate，然后重新登录（令牌可能已过期）
• 确认你的 Aidelly 方案包含 API 访问权限

“Forbidden”错误

• 确保 Claude 使用的工作区是你的 Aidelly 账户有权访问的工作区
• 让 Claude 列出你的工作区并选择正确的工作区

超出速率限制

• 对于每位已登录用户，该服务每分钟允许调用 120 次工具
• 等待几秒后，使用指数退避重试

平台特定问题

• Instagram/TikTok 删除内容： 这些平台不允许通过 API 删除帖子
• LinkedIn 组织路由： 请仔细确认作者目标与账户类型相符（个人成员还是组织）
• 文本过长： 请参照技能文档中的平台限制，确认文本长度

架构

.claude-plugin/
  └─ plugin.json          # Plugin metadata
.mcp.json                 # MCP server configuration
assets/
  └─ icon.png             # 512×512 listing icon
skills/
  └─ aidelly-social/
     └─ SKILL.md          # Tool documentation & examples

API 端点

该插件连接到 https://app.aidelly.ai/api/mcp/public-api（Aidelly 的 MCP HTTP 端点）。

**身份验证：**OAuth 2.1（PKCE + 动态客户端注册），通过服务器的 .well-known/oauth-protected-resource 元数据发现。没有令牌的工具调用会返回 401 和 WWW-Authenticate 挑战，从而启动登录。

服务器公开的工具：

• aidelly_create_post – 立即发布帖子
• aidelly_create_scheduled_post – 安排帖子发布
• aidelly_list_pending_approvals – 查看待审批事项
• 批准或拒绝帖子需在 Aidelly 应用中进行；托管服务不提供审批操作
• aidelly_get_analytics_summary – 获取互动指标
• aidelly_get_post – 获取帖子详情
• aidelly_upload_media – 上传图片/视频
• 可用工具完整列表

发布与分发

本仓库旨在发布到 Claude Code 插件市场。请针对每个分发渠道遵循以下清单。

分发渠道

1. Anthropic Claude Code 插件目录

状态：[待处理 / 进行中 / 已发布]

提交清单：

• README.md 已完善，包含功能、安装和设置说明
• .claude-plugin/plugin.json 有效且描述清晰
• .mcp.json 已针对生产环境 MCP 端点正确配置
• 技能文档内容全面，并包含示例
• 所有 JSON 文件均通过验证（无解析错误）
• 版本号已更新至与发布版本一致（semver）
• 已包含 LICENSE 文件（如有需要）
• 已核查文档准确性

提交方式：

1. 发送邮件至 [email protected] 联系 Anthropic，并提供：
   • GitHub 仓库链接
   • 插件功能简介
   • API 身份验证要求
2. 遵循 Anthropic 的提交流程
3. 在分发门户中查看审批状态

2. 官方 MCP 注册表（Smithery）

状态：[待处理 / 进行中 / 已发布]

**注册表：**https://smithery.ai 或 https://registry.smithery.ai

提交清单：

• GitHub 上的仓库为公开状态
• .mcp.json 符合 MCP 规范 v1.0+
• package.json 中的版本号与 .claude-plugin/plugin.json 一致
• README 包含身份验证设置说明
• 端点 URL 已可用于生产环境（https://）
• 已记录速率限制
• 已记录错误处理方式
• 提供用于验证的测试凭据（可选）

提交方式：

1. Fork MCP 注册表（https://github.com/smithery/smithery-registry）
2. 在 registries.json（或同类文件）中添加条目
3. 添加元数据：名称、版本、描述、身份验证要求、URL
4. 创建拉取请求
5. 根据审核反馈进行修改

3. 已收录于

Glama – https://glama.ai/mcp/servers/Aidelly/claude-plugin

本 README 顶部的徽章显示 Glama 对此服务的实时质量评分。

4. 其他 MCP 注册表

mcp.so – https://mcp.so PulseMCP – https://pulsemcp.com

提交清单（各注册表）：

• 可通过注册表搜索找到该插件
• 元数据正确（名称、描述、作者）
• 生产环境 MCP 端点正常运行
• 已记录身份验证方式
• 已提供联系/支持信息

提交方式：

• 各注册表有各自的提交流程（请查看其网站）
• 通常需要提供 GitHub 仓库、元数据和联系信息

发布前检查清单

提交到任何市场之前：

# 1. Validate JSON files
jq . .claude-plugin/plugin.json
jq . .mcp.json

# 2. Verify the MCP endpoint answers (no token needed for initialize)
curl -s -X POST https://app.aidelly.ai/api/mcp/public-api \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1}'

# 3. Verify the OAuth challenge on a tool call (expect HTTP 401 + WWW-Authenticate)
curl -s -D - -o /dev/null -X POST https://app.aidelly.ai/api/mcp/public-api \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"aidelly_list_workspaces","arguments":{}}}'

# 4. Review skill documentation
cat skills/aidelly-social/SKILL.md | wc -l  # Should be > 200 lines

发布说明

更新 .claude-plugin/plugin.json 和 README 中的版本号时：

## Version 0.2.2

- Uses the renamed tool IDs (for example `aidelly_create_content_automation`); the old IDs stay callable as hidden aliases
- The approval workflow approves in the Aidelly app, because the hosted server does not expose approval actions

## Version 0.2.1

- Adds `privacyPolicyUrl` (https://www.aidelly.ai/privacy-policy) to plugin.json

## Version 0.2.0

- `.mcp.json` declares `"type": "http"` so Claude Code loads the remote server
- Sign-in is OAuth only; no credentials are read from the user's machine
- Adds a 512×512 listing icon

## Version 0.1.0

**Initial release**
- Create, schedule, and publish posts across multiple platforms
- Approval workflow integration
- Analytics summary pull
- Media upload support
- 11 platforms supported

支持

• **问题反馈：**https://github.com/Aidelly/claude-plugin/issues
• **文档：**https://docs.aidelly.ai
• **电子邮件：**[email protected]

许可证

[许可证待定 – 请查看 Aidelly 的开源政策]

维护者

• Aidelly 团队（@aidelly）

---

**最后更新：**2026-10-01
**插件版本：**0.2.2
**MCP 协议版本：**2024-11-05+