{
  "markdown": "# Aidelly Claude Code Plugin\n\n[![Aidelly/claude-plugin MCP server](https://glama.ai/mcp/servers/Aidelly/claude-plugin/badges/score.svg)](https://glama.ai/mcp/servers/Aidelly/claude-plugin)\n\nAutomate Aidelly social media management directly from Claude Code. Create, schedule, and manage posts across all connected platforms with AI-powered MCP tools.\n\n## Features\n\n- **Create & Schedule Posts** – Publish instantly or schedule for later across multiple platforms\n- **Approval Workflows** – Require and manage post approvals before publishing\n- **Analytics** – Pull engagement metrics and top-performing content\n- **Multi-Platform Support** – Instagram, Facebook, LinkedIn, Twitter/X, TikTok, YouTube, Pinterest, Bluesky, Threads, Mastodon, Google Business\n- **Media Upload** – Fetch and upload images/videos directly\n\n## Installation\n\n> **Sign-in is one click.** The Aidelly MCP server supports OAuth 2.1 with PKCE and dynamic client registration, so Claude walks you through an Aidelly login and consent screen automatically — no API key or workspace ID to copy. (An API-key header remains supported for scripted/headless use.)\n\n\n### Install via Claude Code Plugin Marketplace\n\n```bash\n/plugin marketplace add Aidelly/claude-plugin\n```\n\nThen configure your API key (see [Setup](#setup) below).\n\n### Manual Installation (Development)\n\nClone this repository and point Claude Code to the local plugin path:\n\n```bash\ngit clone https://github.com/Aidelly/claude-plugin\ncd claude-plugin\n# Add to Claude Code plugin settings\n```\n\n> **Note:** Ensure `.mcp.json` is committed in your local clone. The Aidelly monorepo ignores `*.mcp.json` files, so the public `Aidelly/claude-plugin` repository explicitly commits it. If you see a missing `.mcp.json` after cloning, run `git check-ignore .mcp.json` — if no output, it's been properly committed.\n\n## Setup\n\n### 1. Generate an API Key\n\n1. Log in to [Aidelly Dashboard](https://app.aidelly.ai)\n2. Go to **Settings → API Keys**\n3. Create a new API key (or use an existing one)\n4. Copy the key\n\n### 2. Configure Environment Variables\n\nSet the following environment variables in your Claude Code environment:\n\n```bash\nexport AIDELLY_API_KEY=your_api_key_here\nexport AIDELLY_WORKSPACE_ID=your_workspace_id  # Optional; required if managing multiple workspaces\n```\n\n**macOS/Linux (shell):**\n\n```bash\n# Add to ~/.zshrc, ~/.bashrc, or equivalent\necho 'export AIDELLY_API_KEY=sk_...' >> ~/.zshrc\nsource ~/.zshrc\n```\n\n**Windows (PowerShell):**\n\n```powershell\n[Environment]::SetEnvironmentVariable('AIDELLY_API_KEY', 'sk_...', 'User')\n```\n\n### 3. Verify Connection\n\nIn Claude Code, run:\n\n```\nUse the MCP server to list accounts or get workspace info.\n```\n\nThe plugin should successfully connect and list your Aidelly workspace data.\n\n## Usage\n\n### Create a Post\n\n```\nCreate a new post on Instagram with the text \"Hello world!\" and upload media.\n```\n\n### Schedule a Post\n\n```\nSchedule a post for tomorrow at 2 PM with approval required.\n```\n\n### Check Pending Approvals\n\n```\nList all posts waiting for approval and approve the first one.\n```\n\n### Pull Analytics\n\n```\nGet the top 10 posts from the last 30 days and their engagement metrics.\n```\n\n## Skill Documentation\n\nFull endpoint reference and examples: [skills/aidelly-social/SKILL.md](./skills/aidelly-social/SKILL.md)\n\n## Configuration\n\n### .mcp.json\n\nThe plugin wires to Aidelly's MCP server via `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"aidelly\": {\n      \"url\": \"https://app.aidelly.ai/api/mcp/public-api\",\n      \"transportType\": \"http\",\n      \"auth\": {\n        \"type\": \"headers\",\n        \"headers\": {\n          \"Authorization\": \"Bearer ${AIDELLY_API_KEY}\",\n          \"x-aidelly-workspace-id\": \"${AIDELLY_WORKSPACE_ID}\"\n        }\n      }\n    }\n  }\n}\n```\n\n### plugin.json\n\nMetadata for Claude Code plugin marketplace:\n\n```json\n{\n  \"name\": \"aidelly\",\n  \"description\": \"Aidelly social content automation for Claude Code\",\n  \"author\": \"Aidelly\",\n  \"version\": \"0.1.0\"\n}\n```\n\n## Troubleshooting\n\n### \"Unauthorized\" Error\n\n- Verify `AIDELLY_API_KEY` is set correctly\n- Confirm the API key is active in Aidelly Dashboard\n- Check that the workspace exists\n\n### \"Forbidden\" Error\n\n- Ensure your API key has access to the workspace\n- If using `AIDELLY_WORKSPACE_ID`, verify it matches a workspace you have access to\n\n### Rate Limit Exceeded\n\n- The plugin enforces 120 tool calls per minute per API key\n- Retry after a few seconds with exponential backoff\n\n### Platform-Specific Issues\n\n- **Instagram/TikTok deletion:** These platforms don't allow post deletion via API\n- **LinkedIn org routing:** Double-check that the author target matches your account type (member vs. organization)\n- **Text too long:** Verify text length against platform limits in the skill documentation\n\n## Architecture\n\n```\n.claude-plugin/\n  └─ plugin.json          # Plugin metadata\n.mcp.json                 # MCP server configuration\nskills/\n  └─ aidelly-social/\n     └─ SKILL.md          # Tool documentation & examples\n```\n\n## API Endpoints\n\nThe plugin connects to `https://app.aidelly.ai/api/mcp/public-api` (Aidelly's MCP HTTP endpoint).\n\n**Authentication:** `Authorization: Bearer <API_KEY>` (required)\n\n**Tools exposed by the server:**\n\n- `aidelly_create_post` – Instant post publish\n- `aidelly_create_scheduled_post` – Schedule a post\n- `aidelly_list_pending_approvals` – Check pending approvals\n- `aidelly_post_approvals_id_action` – Approve/reject posts\n- `aidelly_get_analytics_summary` – Pull engagement metrics\n- `aidelly_get_post` – Get post details\n- `aidelly_upload_media` – Upload image/video\n- [Full list of available tools](./skills/aidelly-social/SKILL.md)\n\n## Publishing & Distribution\n\nThis repository is designed to be published to Claude Code plugin marketplaces. Follow the checklist below for each distribution channel.\n\n### Distribution Channels\n\n#### 1. Anthropic Claude Code Plugin Directory\n\n**Status:** [Pending / In progress / Published]\n\n**Submission checklist:**\n\n- [ ] README.md complete with features, installation, setup\n- [ ] .claude-plugin/plugin.json valid and descriptive\n- [ ] .mcp.json correctly configured for production MCP endpoint\n- [ ] Skills documentation comprehensive with examples\n- [ ] All JSON files validate (no parse errors)\n- [ ] Version bumped to match release (semver)\n- [ ] LICENSE file included (if required)\n- [ ] Documentation reviewed for accuracy\n\n**How to submit:**\n\n1. Contact Anthropic at plugins@anthropic.com with:\n   - GitHub repository link\n   - Brief description of plugin capabilities\n   - API authentication requirements\n2. Follow Anthropic's submission process\n3. Monitor distribution portal for approval status\n\n#### 2. Official MCP Registry (Smithery)\n\n**Status:** [Pending / In progress / Published]\n\n**Registry:** https://smithery.ai or https://registry.smithery.ai\n\n**Submission checklist:**\n\n- [ ] Repository public on GitHub\n- [ ] .mcp.json follows MCP spec v1.0+\n- [ ] Version in package.json matches .claude-plugin/plugin.json\n- [ ] README includes authentication setup\n- [ ] Endpoint URL is production-ready (https://)\n- [ ] Rate limits documented\n- [ ] Error handling documented\n- [ ] Test credentials available for verification (optional)\n\n**How to submit:**\n\n1. Fork the MCP registry (https://github.com/smithery/smithery-registry)\n2. Add entry in registries.json (or equivalent)\n3. Include metadata: name, version, description, auth requirements, URL\n4. Open pull request\n5. Address review feedback\n\n#### 3. Listed on\n\n**Glama** – https://glama.ai/mcp/servers/Aidelly/claude-plugin\n\nThe badge at the top of this README reflects Glama's live quality score for\nthis server.\n\n#### 4. Alternative MCP Registries\n\n**mcp.so** – https://mcp.so\n**PulseMCP** – https://pulsemcp.com\n\n**Submission checklist (each):**\n\n- [ ] Plugin discoverable via their search\n- [ ] Correct metadata (name, description, author)\n- [ ] Production MCP endpoint working\n- [ ] Authentication method documented\n- [ ] Contact/support information provided\n\n**How to submit:**\n\n- Each registry has its own submission process (check their websites)\n- Generally requires GitHub repo + metadata + contact info\n\n### Pre-Release Checklist\n\nBefore submitting to any marketplace:\n\n```bash\n# 1. Validate JSON files\njq . .claude-plugin/plugin.json\njq . .mcp.json\n\n# 2. Verify MCP endpoint connectivity\ncurl -H \"Authorization: Bearer $AIDELLY_API_KEY\" \\\n  https://app.aidelly.ai/api/mcp/public-api \\\n  -X POST \\\n  -d '{\"jsonrpc\":\"2.0\",\"method\":\"initialize\",\"id\":1}' \\\n  -H \"Content-Type: application/json\"\n\n# 3. Test API key setup\nexport AIDELLY_API_KEY=test_key\necho \"API key set: $AIDELLY_API_KEY\"\n\n# 4. Review skill documentation\ncat skills/aidelly-social/SKILL.md | wc -l  # Should be > 200 lines\n```\n\n### Release Notes\n\nWhen bumping version in `.claude-plugin/plugin.json` and README:\n\n```\n## Version 0.1.0\n\n**Initial release**\n- Create, schedule, and publish posts across multiple platforms\n- Approval workflow integration\n- Analytics summary pull\n- Media upload support\n- 11 platforms supported\n```\n\n## Support\n\n- **Issues:** https://github.com/Aidelly/claude-plugin/issues\n- **Docs:** https://docs.aidelly.ai\n- **Email:** support@aidelly.ai\n\n## License\n\n[License TBD – check Aidelly open-source policy]\n\n## Maintainers\n\n- Aidelly Team (@aidelly)\n\n---\n\n**Last updated:** 2026-07-13  \n**Plugin version:** 0.1.0  \n**MCP protocol version:** 2024-11-05+\n",
  "bytes": 9358,
  "sha": "b8d69d13bf83a57d4e4629695007cfe4ed822473b30e21646b197cccff5b75e7",
  "repo_slug": "aidelly/claude-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_wilzer_aidelly_dd24b4a4/readme"
}