SosoAPI installeren: pakketten, clients en externe MCP

Welk npm-pakket moet ik installeren?

Installeer sosoapi voor een nieuwe configuratie. De pakketten @sosoapi/cli, sosoapi-cli en sosoapi-mcp zijn aliassen die exact dezelfde sosoapi-versie installeren. Ze voeren dezelfde CLI- en MCP-tools uit, dus je hebt maar één pakket nodig.

Lokale MCP vereist Node.js 20 of later en npm/npx. Gehoste MCP vereist geen lokaal pakket. Meld je na installatie of verbinding aan om toegang tot je accounts te verlenen.

• sosoapi
• @sosoapi/cli
• sosoapi-cli
• sosoapi-mcp

Verbind een lokale MCP-client

Gebruik onderstaande opdrachten om een core-profielverbinding toe te voegen. Als SosoAPI al verbonden is en werkt, behoud die verbinding. sosoapi zonder argumenten start de stdio MCP-server; die wacht op de client via stdin.

Voeg voor Claude Desktop, Cursor of een andere stdio-client onderstaande JSON toe aan de MCP-instellingen. Locatie en goedkeuringsstappen verschillen per client. Herstart of verbind zo nodig opnieuw en controleer daarna of SosoAPI-tools in je gesprek beschikbaar zijn.

claude mcp add sosoapi -e SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

codex mcp add sosoapi --env SOSOAPI_TOOL_PROFILE=core -- npx -y sosoapi

{
  "mcpServers": {
    "sosoapi": {
      "command": "npx",
      "args": [
        "-y",
        "sosoapi"
      ],
      "env": {
        "SOSOAPI_TOOL_PROFILE": "core"
      }
    }
  }
}

• Naslag voor MCP-tools

Verbind externe MCP met OAuth

Voeg onderstaande URL toe in een client die externe MCP, OAuth en dynamische clientregistratie ondersteunt. Meld je aan via de browser en kies de werkruimten en acties die je wilt toestaan. Je hoeft geen API-sleutel, client-ID of clientgeheim te plakken. Importeer een openbare URL om media via HTTP aan te leveren; lokale bestandsupload vereist de lokale MCP-server.

Aangepaste ChatGPT-apps en externe Claude-connectors hangen af van je abonnement en de beschikbare connectorinstellingen in die client. Deze instructies stellen een aangepaste verbinding in; ze beschrijven geen vermelding in een appcatalogus.

https://gqeshlawtcexsapabaui.supabase.co/functions/v1/remote-mcp

• Authenticatie en machtigingen

Verifieer de configuratie zonder te publiceren

Controleer de authenticatiestatus en meld je zo nodig aan. Lees werkruimtecontext en verbonden accounts en bevestig dat het teruggegeven account en de werkruimte de bedoelde zijn. Dit verifieert toegang zonder een bericht in te dienen; publicatie hangt nog steeds af van de accountmachtigingen.

Je hoeft geen testbericht te publiceren om de configuratie af te ronden. Ga verder met je oorspronkelijke taak en bestaande inhoud. De gebruiker voltooit de providertoestemming en beoordeelt bestemming, inhoud en tijdstip vóór elke gevraagde schrijfhandeling.

npx sosoapi auth status

npx sosoapi api contract --route /identity-api/workspace/list --summary

Werk een versie bij of zet die vast

Voer npx -y sosoapi@latest --help uit om de huidige CLI op te halen en herstart daarna je MCP-client. Heeft de client een opgeslagen opdracht, zet dan de gewenste versie in de args. Aliassen blijven gekoppeld aan hun exacte sosoapi-versie; een aparte globale installatie bijwerken verandert die niet.

Vergelijk bij een fout door versieverschil het geïnstalleerde contract met de benodigde bewerking. Werk het pakket bij in de opdracht die je MCP-client werkelijk gebruikt, verbind opnieuw en probeer die bewerking opnieuw. Een schemaverschil vereist geen nieuwe inloggegevens of ruimere toegang.

npx -y sosoapi@latest --help

npx sosoapi api contract --summary

• Probleemoplossing