Skip to main content
Glama
Oliviercreativ

social-mic-mcp

README.md
# Serveur MCP — Social Made in Conflans

Pilote tes posts (génération, planification, publication) depuis Claude / un agent
via le protocole MCP. Il appelle l'API publique `/api/v1` avec ta clé.

## Installation

Publié sur NPM — aucune installation manuelle, `npx` s'en charge :

```bash
npx -y social-mic-mcp
```

(ou en local depuis le repo : `cd mcp && npm install && node index.mjs`)

## Configuration

1. Crée une clé dans l'app : **Paramètres → API & intégrations → Nouvelle clé** (`smic_…`).
2. Ajoute le serveur à ton client MCP.

### Claude Desktop / Claude Code (`mcp` config)

```json
{
  "mcpServers": {
    "social-mic": {
      "command": "npx",
      "args": ["-y", "social-mic-mcp"],
      "env": {
        "SOCIAL_API_KEY": "smic_xxxxxxxxxxxx",
        "SOCIAL_API_URL": "https://social.madeinconflans.fr"
      }
    }
  }
}
```

## Outils exposés

| Outil | Rôle |
|---|---|
| `generate_post` | Génère un texte + hashtags (description, tone?, platform?) |
| `create_post` | Crée un brouillon / planifie (content_text, scheduled_at?, social_account_id?, media_url?, link?) |
| `publish_post` | Publie **tout de suite** un post existant (id, social_account_id?) |
| `list_posts` | Derniers posts |
| `list_accounts` | Comptes connectés (pour `social_account_id`) |

## Exemple d'usage (langage naturel)

> « Génère 3 posts pour ma boulangerie cette semaine et planifie-les à 9h sur Facebook. »

L'agent appelle `list_accounts`, puis `generate_post` ×3, puis `create_post` avec
`scheduled_at` (UTC) et le `social_account_id` Facebook.

## Notes

- Dates `scheduled_at` en **UTC ISO 8601** (ex: `2026-07-01T07:00:00Z` = 9h Paris l'été).
- Posts illimités par organisation.
- Un post `link` est publié sur Facebook ; Instagram exige une image.