Aidelly

Gestión de redes sociales operada por agentes para agencias: publica, programa, aprueba y analiza publicaciones en 11 redes (www.aidelly.ai).

GitHub

Documentación

Plugin de Claude Code para Aidelly

Aidelly/claude-plugin MCP server

Automatiza la gestión de redes sociales de Aidelly directamente desde Claude Code. Crea, programa y gestiona publicaciones en todas las plataformas conectadas con herramientas MCP impulsadas por IA.

Características

  • Crear y programar publicaciones – Publica al instante o programa para más tarde en múltiples plataformas
  • Flujos de aprobación – Requiere y gestiona aprobaciones de publicaciones antes de publicar
  • Analíticas – Obtén métricas de interacción y contenido de mejor rendimiento
  • Soporte multi-plataforma – Instagram, Facebook, LinkedIn, Twitter/X, TikTok, YouTube, Pinterest, Bluesky, Threads, Mastodon, Google Business
  • Carga de medios – Obtén y sube imágenes/videos directamente

Instalación

El inicio de sesión es de un clic. El servidor MCP de Aidelly soporta OAuth 2.1 con PKCE y registro dinámico de clientes, por lo que Claude te guía automáticamente a través de una pantalla de inicio de sesión y consentimiento de Aidelly — sin necesidad de copiar una clave API o ID de espacio de trabajo. (Un encabezado de clave API sigue siendo compatible para uso mediante scripts/headless).

Instalar a través del Marketplace de Plugins de Claude Code

/plugin marketplace add Aidelly/claude-plugin

Luego configura tu clave API (consulta Configuración a continuación).

Instalación Manual (Desarrollo)

Clona este repositorio y apunta Claude Code a la ruta local del plugin:

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

Nota: Asegúrate de que .mcp.json esté confirmado en tu clon local. El monorepo de Aidelly ignora los archivos *.mcp.json, por lo que el repositorio público Aidelly/claude-plugin lo confirma explícitamente. Si ves un .mcp.json faltante después de clonar, ejecuta git check-ignore .mcp.json — si no hay salida, se ha confirmado correctamente.

Configuración

1. Generar una Clave API

  1. Inicia sesión en Panel de Aidelly
  2. Ve a Configuración → Claves API
  3. Crea una nueva clave API (o usa una existente)
  4. Copia la clave

2. Configurar Variables de Entorno

Establece las siguientes variables de entorno en tu entorno de 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 la Conexión

En Claude Code, ejecuta:

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

El plugin debería conectarse correctamente y listar los datos de tu espacio de trabajo de Aidelly.

Uso

Crear una Publicación

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

Programar una Publicación

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

Consultar Aprobaciones Pendientes

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

Obtener Analíticas

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

Documentación de Habilidades

Referencia completa de endpoints y ejemplos: skills/aidelly-social/SKILL.md

Configuración

.mcp.json

El plugin se conecta al servidor MCP de Aidelly a través de .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

Metadatos para el marketplace de plugins de Claude Code:

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

Solución de Problemas

Error "No Autorizado"

  • Verifica que AIDELLY_API_KEY esté configurado correctamente
  • Confirma que la clave API esté activa en el Panel de Aidelly
  • Comprueba que el espacio de trabajo exista

Error "Prohibido"

  • Asegúrate de que tu clave API tenga acceso al espacio de trabajo
  • Si usas AIDELLY_WORKSPACE_ID, verifica que coincida con un espacio de trabajo al que tengas acceso

Límite de Velocidad Excedido

  • El plugin aplica un límite de 120 llamadas de herramientas por minuto por clave API
  • Reintenta después de unos segundos con retroceso exponencial

Problemas Específicos de Plataforma

  • Eliminación en Instagram/TikTok: Estas plataformas no permiten la eliminación de publicaciones a través de la API
  • Enrutamiento de organizaciones en LinkedIn: Verifica que el autor objetivo coincida con tu tipo de cuenta (miembro vs. organización)
  • Texto demasiado largo: Verifica la longitud del texto según los límites de la plataforma en la documentación de habilidades

Arquitectura

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

Endpoints de API

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

Autenticación: Authorization: Bearer <API_KEY> (requerida)

Herramientas expuestas por el servidor:

  • aidelly_create_post – Publicación instantánea
  • aidelly_create_scheduled_post – Programar una publicación
  • aidelly_list_pending_approvals – Consultar aprobaciones pendientes
  • aidelly_post_approvals_id_action – Aprobar/rechazar publicaciones
  • aidelly_get_analytics_summary – Obtener métricas de interacción
  • aidelly_get_post – Obtener detalles de la publicación
  • aidelly_upload_media – Subir imagen/video
  • Lista completa de herramientas disponibles

Publicación y Distribución

Este repositorio está diseñado para publicarse en marketplaces de plugins de Claude Code. Sigue la lista de verificación a continuación para cada canal de distribución.

Canales de Distribución

1. Directorio de Plugins de Claude Code de Anthropic

Estado: [Pendiente / En progreso / Publicado]

Lista de verificación para envío:

  • README.md completo con características, instalación y configuración
  • .claude-plugin/plugin.json válido y descriptivo
  • .mcp.json configurado correctamente para el endpoint MCP de producción
  • Documentación de habilidades completa con ejemplos
  • Todos los archivos JSON validados (sin errores de análisis)
  • Versión actualizada para coincidir con el lanzamiento (semver)
  • Archivo LICENSE incluido (si se requiere)
  • Documentación revisada para precisión

Cómo enviar:

  1. Contacta a Anthropic en plugins@anthropic.com con:
    • Enlace al repositorio de GitHub
    • Breve descripción de las capacidades del plugin
    • Requisitos de autenticación de API
  2. Sigue el proceso de envío de Anthropic
  3. Monitorea el portal de distribución para el estado de aprobación

2. Registro Oficial MCP (Smithery)

Estado: [Pendiente / En progreso / Publicado]

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

Lista de verificación para envío:

  • Repositorio público en GitHub
  • .mcp.json sigue la especificación MCP v1.0+
  • La versión en package.json coincide con .claude-plugin/plugin.json
  • README incluye configuración de autenticación
  • La URL del endpoint está lista para producción (https://)
  • Límites de velocidad documentados
  • Manejo de errores documentado
  • Credenciales de prueba disponibles para verificación (opcional)

Cómo enviar:

  1. Haz un fork del registro MCP (https://github.com/smithery/smithery-registry)
  2. Agrega una entrada en registries.json (o equivalente)
  3. Incluye metadatos: nombre, versión, descripción, requisitos de autenticación, URL
  4. Abre una solicitud de extracción (pull request)
  5. Atiende los comentarios de revisión

3. Listado en

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

La insignia en la parte superior de este README refleja la puntuación de calidad en vivo de Glama para este servidor.

4. Registros MCP Alternativos

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

Lista de verificación para envío (cada uno):

  • Plugin detectable a través de su búsqueda
  • Metadatos correctos (nombre, descripción, autor)
  • Endpoint MCP de producción funcionando
  • Método de autenticación documentado
  • Información de contacto/soporte proporcionada

Cómo enviar:

  • Cada registro tiene su propio proceso de envío (consulta sus sitios web)
  • Generalmente requiere repositorio de GitHub + metadatos + información de contacto

Lista de Verificación Pre-Lanzamiento

Antes de enviar a cualquier 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 Lanzamiento

Al actualizar la versión en .claude-plugin/plugin.json y el 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

Soporte

Licencia

[Licencia por determinar – consulta la política de código abierto de Aidelly]

Mantenedores

  • Equipo de Aidelly (@aidelly)

Última actualización: 2026-07-13
Versión del plugin: 0.1.0
Versión del protocolo MCP: 2024-11-05+