aidelly

Aidelly Claude Code プラグイン

Claude Code から Aidelly のソーシャルメディア管理を直接自動化します。AI を活用した MCP ツールで、接続済みのすべてのプラットフォームに投稿を作成、予約、管理できます。

機能

• 投稿の作成と予約 – 複数のプラットフォームに即時公開するか、後で公開するよう予約できます
• 承認ワークフロー – 公開前に投稿の承認を必須にし、管理できます
• アナリティクス – エンゲージメント指標とパフォーマンス上位のコンテンツを取得できます
• マルチプラットフォーム対応 – Instagram、Facebook、LinkedIn、Twitter/X、TikTok、YouTube、Pinterest、Bluesky、Threads、Mastodon、Google Business
• メディアのアップロード – 画像や動画を直接取得してアップロードできます

インストール

サインインはワンクリックです。 Aidelly MCP サーバーは、PKCE を使用した OAuth 2.1 と動的クライアント登録に対応しています。Claude が Aidelly のログイン画面と同意画面への手続きを案内するため、キーやワークスペース ID をコピーする必要はなく、このプラグインがマシン上の認証情報を読み取ることもありません。

Claude Code Plugin Marketplace からインストール

/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 のモノレポでは *.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 メタデータから検出されます。トークンなしでツールを呼び出すと、WWW-Authenticate チャレンジを伴う 401 が返され、サインインが開始されます。

サーバーが公開するツール：

• 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 spec v1.0+ に準拠している
• package.json のバージョンが .claude-plugin/plugin.json と一致している
• README に認証のセットアップ方法が記載されている
• エンドポイント URL が本番環境で使用できる（https://）
• レート制限を記載している
• エラー処理を記載している
• 検証用のテスト認証情報を用意している（任意）

提出方法：

1. 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+