Sinapsi
EnglishAccedi

Sviluppatori

Un solo modello di credenziali, due protocolli: MCP per gli assistenti, REST per il tuo codice. Gli stessi token ovunque.

Endpoint MCP

Ogni endpoint parla Streamable HTTP (MCP). Funziona con Claude (Code, Desktop, claude.ai), col connettore MCP della Claude API e con qualunque client MCP.

  • https://sinapsi.wiki/mcp/hub/ — tutti i wiki pubblici, senza auth: chiama list_wikis, poi passa l'id nel parametro wiki di search/get_page/neighbors. Il cambio wiki è un parametro, non uno stato.
  • https://sinapsi.wiki/mcp/w/<id>/ — un singolo wiki pubblico, isolato per URL, senza auth.
  • https://sinapsi.wiki/mcp/ — i tuoi spazi privati: Bearer token (di account o di spazio, generato nell'app), oppure OAuth da Claude Desktop / claude.ai. Con una credenziale di account usi my_spaces e il parametro space per muoverti tra i tuoi spazi.

API REST

Lo stesso token di account vale su /api/v1 (i token di spazio sono solo-MCP). Lo generi nell'app: Spazi → «Costruisci un wiki col tuo assistente» → Genera comando.

# i tuoi spazi
curl -H "Authorization: Bearer $SINAPSI_TOKEN" https://sinapsi.wiki/api/v1/spaces

# interroga uno spazio, con citazioni e note di frontiera
curl -H "Authorization: Bearer $SINAPSI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"question": "che tone of voice usa il brand?"}' \
  https://sinapsi.wiki/api/v1/spaces/<space-id>/ask

Schema machine-readable: OpenAPI (JSON). I wiki pubblici non richiedono token: GET /api/v1/public/wikis e affini.

Usarlo da un agente

Con la Claude API punti il connettore MCP da noi — il tuo agente riceve search, get_page, neighbors, confirm_use come tool:

client.beta.messages.create(
    model="claude-opus-4-8", max_tokens=2048,
    betas=["mcp-client-2025-11-20"],
    mcp_servers=[{"type": "url", "name": "sinapsi",
                  "url": "https://sinapsi.wiki/mcp/",
                  "authorization_token": SINAPSI_TOKEN}],
    tools=[{"type": "mcp_toolset", "mcp_server_name": "sinapsi"}],
    messages=[{"role": "user", "content": "…"}],
)

Collegarsi da qualunque client

Claude Code — il comando generato nell'app funziona così com'è; vale per la cartella di progetto corrente (scope local). Aggiungi -s user per averlo in tutti i progetti. Senza header, esegui /mcp per accedere via OAuth.

Claude Desktop / claude.ai — Impostazioni → Connettori → aggiungi https://sinapsi.wiki/mcp/ e accedi. Disponibile su tutti i piani (il Free include un connettore personalizzato). La connessione parte dal cloud di Anthropic: funziona uguale su web, desktop e mobile.

ChatGPT (Plus/Pro/Business) — Settings → Apps & Connectors → attiva Developer mode → Create app → https://sinapsi.wiki/mcp/. I connettori di ChatGPT accedono via OAuth (che supportiamo nativamente) — il Bearer statico non è un'opzione nella UI.

OpenAI Responses API — il token va passato a ogni chiamata:

tools=[{"type": "mcp", "server_label": "sinapsi",
        "server_url": "https://sinapsi.wiki/mcp/",
        "authorization": SINAPSI_TOKEN, "require_approval": "never"}]

VS Code / GitHub Copilot — .vscode/mcp.json (attenzione: la chiave è servers):

{"servers": {"sinapsi": {"type": "http",
  "url": "https://sinapsi.wiki/mcp/",
  "headers": {"Authorization": "Bearer IL_TUO_TOKEN"}}}}

Gemini CLI — gemini mcp add --transport http sinapsi https://sinapsi.wiki/mcp/ --header "Authorization: Bearer IL_TUO_TOKEN" (in settings.json la chiave è httpUrl, non url).

Cursor / Windsurf / Cline — stesso endpoint e stesso header; cambia solo la chiave del transport: url (Cursor), serverUrl (Windsurf), "type": "streamableHttp" (Cline).

Fair use

Le richieste hanno un rate limit per token/IP (HTTP 429 con Retry-After oltre il budget — generoso per uso interattivo e agentico). I token sono credenziali: trattali come password, revocali dall'app se esposti. Per uso commerciale ad alto volume del corpus pubblico scrivi a privacy@sinapsi.wiki.