Aidelly

Gerenciamento de mídias sociais operado por agentes para agências — publique, agende, aprove e analise posts em 11 redes (www.aidelly.ai).

GitHub

Documentação

Plugin Aidelly Claude Code

Aidelly/claude-plugin MCP server

Automatize o gerenciamento de mídias sociais da Aidelly diretamente do Claude Code. Crie, agende e gerencie publicações em todas as plataformas conectadas com ferramentas MCP alimentadas por IA.

Recursos

  • Criar e agendar publicações – Publique instantaneamente ou agende para depois em várias plataformas
  • Fluxos de aprovação – Exija e gerencie aprovações de publicações antes de publicar
  • Analytics – Obtenha métricas de engajamento e conteúdos de melhor desempenho
  • Suporte a múltiplas plataformas – Instagram, Facebook, LinkedIn, Twitter/X, TikTok, YouTube, Pinterest, Bluesky, Threads, Mastodon, Google Business
  • Upload de mídia – Busque e envie imagens/vídeos diretamente

Instalação

O login é feito com um clique. O servidor MCP da Aidelly suporta OAuth 2.1 com PKCE e registro dinâmico de clientes, então o Claude guia você por uma tela de login e consentimento da Aidelly automaticamente — sem necessidade de copiar chave de API ou ID de workspace. (Um cabeçalho de chave de API continua sendo suportado para uso via script/headless.)

Instalar via Marketplace de Plugins do Claude Code

/plugin marketplace add Aidelly/claude-plugin

Em seguida, configure sua chave de API (veja Configuração abaixo).

Instalação Manual (Desenvolvimento)

Clone este repositório e aponte o Claude Code para o caminho local do plugin:

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

Observação: Certifique-se de que .mcp.json esteja commitado no seu clone local. O monorepo da Aidelly ignora arquivos *.mcp.json, então o repositório público Aidelly/claude-plugin o commita explicitamente. Se você notar que .mcp.json está ausente após clonar, execute git check-ignore .mcp.json — se não houver saída, ele foi commitado corretamente.

Configuração

1. Gerar uma Chave de API

  1. Faça login no Painel da Aidelly
  2. Vá para Configurações → Chaves de API
  3. Crie uma nova chave de API (ou use uma existente)
  4. Copie a chave

2. Configurar Variáveis de Ambiente

Defina as seguintes variáveis de ambiente no seu ambiente Claude Code:

export AIDELLY_API_KEY=your_api_key_here
export AIDELLY_WORKSPACE_ID=your_workspace_id  # Optional; required if managing multiple workspaces

macOS/Linux (shell):

# Add to ~/.zshrc, ~/.bashrc, or equivalent
echo 'export AIDELLY_API_KEY=sk_...' >> ~/.zshrc
source ~/.zshrc

Windows (PowerShell):

[Environment]::SetEnvironmentVariable('AIDELLY_API_KEY', 'sk_...', 'User')

3. Verificar a Conexão

No Claude Code, execute:

Use the MCP server to list accounts or get workspace info.

O plugin deve conectar com sucesso e listar os dados do seu workspace da Aidelly.

Uso

Criar uma Publicação

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

Agendar uma Publicação

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

Verificar Aprovações Pendentes

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

Obter Analytics

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

Documentação das Skills

Referência completa de endpoints e exemplos: skills/aidelly-social/SKILL.md

Configuração

.mcp.json

O plugin se conecta ao servidor MCP da Aidelly via .mcp.json:

{
  "mcpServers": {
    "aidelly": {
      "url": "https://app.aidelly.ai/api/mcp/public-api",
      "transportType": "http",
      "auth": {
        "type": "headers",
        "headers": {
          "Authorization": "Bearer ${AIDELLY_API_KEY}",
          "x-aidelly-workspace-id": "${AIDELLY_WORKSPACE_ID}"
        }
      }
    }
  }
}

plugin.json

Metadados para o marketplace de plugins do Claude Code:

{
  "name": "aidelly",
  "description": "Aidelly social content automation for Claude Code",
  "author": "Aidelly",
  "version": "0.1.0"
}

Solução de Problemas

Erro "Unauthorized"

  • Verifique se AIDELLY_API_KEY está definido corretamente
  • Confirme se a chave de API está ativa no Painel da Aidelly
  • Verifique se o workspace existe

Erro "Forbidden"

  • Certifique-se de que sua chave de API tenha acesso ao workspace
  • Se estiver usando AIDELLY_WORKSPACE_ID, verifique se ele corresponde a um workspace ao qual você tem acesso

Limite de Taxa Excedido

  • O plugin aplica um limite de 120 chamadas de ferramenta por minuto por chave de API
  • Tente novamente após alguns segundos com backoff exponencial

Problemas Específicos de Plataforma

  • Exclusão no Instagram/TikTok: Essas plataformas não permitem exclusão de publicações via API
  • Roteamento de organizações no LinkedIn: Verifique novamente se o autor de destino corresponde ao seu tipo de conta (membro vs. organização)
  • Texto muito longo: Verifique o limite de caracteres da plataforma na documentação das skills

Arquitetura

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

Endpoints da API

O plugin se conecta a https://app.aidelly.ai/api/mcp/public-api (endpoint HTTP MCP da Aidelly).

Autenticação: Authorization: Bearer <API_KEY> (obrigatória)

Ferramentas expostas pelo servidor:

  • aidelly_create_post – Publicação instantânea
  • aidelly_create_scheduled_post – Agendar uma publicação
  • aidelly_list_pending_approvals – Verificar aprovações pendentes
  • aidelly_post_approvals_id_action – Aprovar/rejeitar publicações
  • aidelly_get_analytics_summary – Obter métricas de engajamento
  • aidelly_get_post – Obter detalhes da publicação
  • aidelly_upload_media – Enviar imagem/vídeo
  • Lista completa de ferramentas disponíveis

Publicação e Distribuição

Este repositório foi projetado para ser publicado em marketplaces de plugins do Claude Code. Siga a lista de verificação abaixo para cada canal de distribuição.

Canais de Distribuição

1. Diretório de Plugins do Anthropic Claude Code

Status: [Pendente / Em andamento / Publicado]

Lista de verificação para submissão:

  • README.md completo com recursos, instalação e configuração
  • .claude-plugin/plugin.json válido e descritivo
  • .mcp.json configurado corretamente para o endpoint MCP de produção
  • Documentação das skills abrangente com exemplos
  • Todos os arquivos JSON validados (sem erros de análise)
  • Versão atualizada para corresponder ao release (semver)
  • Arquivo LICENSE incluído (se necessário)
  • Documentação revisada quanto à precisão

Como enviar:

  1. Entre em contato com a Anthropic em plugins@anthropic.com com:
    • Link do repositório no GitHub
    • Breve descrição dos recursos do plugin
    • Requisitos de autenticação da API
  2. Siga o processo de submissão da Anthropic
  3. Acompanhe o status de aprovação no portal de distribuição

2. Registro Oficial MCP (Smithery)

Status: [Pendente / Em andamento / Publicado]

Registro: https://smithery.ai ou https://registry.smithery.ai

Lista de verificação para submissão:

  • Repositório público no GitHub
  • .mcp.json segue a especificação MCP v1.0+
  • Versão no package.json corresponde ao .claude-plugin/plugin.json
  • README inclui configuração de autenticação
  • URL do endpoint pronta para produção (https://)
  • Limites de taxa documentados
  • Tratamento de erros documentado
  • Credenciais de teste disponíveis para verificação (opcional)

Como enviar:

  1. Faça um fork do registro MCP (https://github.com/smithery/smithery-registry)
  2. Adicione uma entrada em registries.json (ou equivalente)
  3. Inclua metadados: nome, versão, descrição, requisitos de autenticação, URL
  4. Abra um pull request
  5. Responda ao feedback da revisão

3. Listado em

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

O selo no topo deste README reflete a pontuação de qualidade ao vivo da Glama para este servidor.

4. Registros MCP Alternativos

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

Lista de verificação para submissão (cada um):

  • Plugin encontrável pela busca deles
  • Metadados corretos (nome, descrição, autor)
  • Endpoint MCP de produção funcionando
  • Método de autenticação documentado
  • Informações de contato/suporte fornecidas

Como enviar:

  • Cada registro tem seu próprio processo de submissão (consulte os sites deles)
  • Geralmente exige repositório no GitHub + metadados + informações de contato

Lista de Verificação Pré-Release

Antes de enviar para qualquer marketplace:

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

# 2. Verify MCP endpoint connectivity
curl -H "Authorization: Bearer $AIDELLY_API_KEY" \
  https://app.aidelly.ai/api/mcp/public-api \
  -X POST \
  -d '{"jsonrpc":"2.0","method":"initialize","id":1}' \
  -H "Content-Type: application/json"

# 3. Test API key setup
export AIDELLY_API_KEY=test_key
echo "API key set: $AIDELLY_API_KEY"

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

Notas de Release

Ao atualizar a versão em .claude-plugin/plugin.json e no README:

## 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

Suporte

Licença

[Licença a definir – verifique a política de código aberto da Aidelly]

Mantenedores

  • Equipe Aidelly (@aidelly)

Última atualização: 2026-07-13
Versão do plugin: 0.1.0
Versão do protocolo MCP: 2024-11-05+