Apri SweetHive

Configurazione del connettore MCP

SweetHive espone la sua Agent Client API come server MCP. Qualsiasi agente compatibile MCP — Claude Desktop, Claude Code, Cowork, agenti di classe OpenClaw e altri — si collega con un unico token di accesso con ambito limitato che emetti da SweetHive. Un solo server, un solo modello di token, ogni client.

Per prima cosa, crea un token in I miei agenti → Collega un agente e scarica il pacchetto di configurazione (contiene il tuo endpoint e il tuo token).

Cosa ottiene il tuo agente

Strumento Cosa fa
whoami l'ambito effettivo del token, la capacità e il proprietario
contexts l'albero di hive/contesti concessi
items gli elementi recenti di un contesto e del suo sottoalbero
search cerca messaggi, note e file nei contesti concessi
post_message pubblica in un contesto (solo token Lettura + pubblicazione; la prima pubblicazione chiede la tua conferma)
chat_pull / chat_reply la chat dentro SweetHive con te

Configura il tuo client

Connettore locale (stdio) — funziona già oggi con Claude Desktop, Claude Code e qualsiasi client MCP stdio. Installa il connettore SweetHive pacchettizzato, poi aggiungi:

{
  "mcpServers": {
    "sweethive": {
      "command": "node",
      "args": ["/absolute/path/to/sweethive-connector/dist/index.js"],
      "env": {
        "SWEETHIVE_ENDPOINT": "https://sweethive.com/server/web",
        "SWEETHIVE_TOKEN": "shv_..."
      }
    }
  }
}

Remoto (HTTP streamable) — dove l'endpoint MCP ospitato è abilitato, punta il tuo client verso di esso con il token come credenziale Bearer:

{
  "mcpServers": {
    "sweethive": {
      "url": "https://sweethive.com/mcp",
      "headers": { "Authorization": "Bearer shv_..." }
    }
  }
}

Il tuo agente ora può rispondere a domande come “cosa è cambiato nel Progetto A questa settimana?” o “prepara un aggiornamento di stato per il DevGroup.”

Note

  • La capacità (Lettura / Lettura + bozze / Lettura + pubblicazione) è fissata sul token; la sola lettura è l'impostazione predefinita.
  • Revoca e cambi di gruppo hanno effetto immediato — non esiste ambito in cache. Una configurazione trapelata espone un ambito limitato e revocabile, mai le credenziali del tuo account.
  • I contenuti in arrivo da un agente esterno sono trattati come non attendibili: non possono contenere menzioni privilegiate né invocare gli agenti interni di SweetHive, e sono soggetti a rate limit per token.