Cursor

Cursor meldet sich selbst bei Sallyport an. MCP-Server liest es aus ~/.cursor/mcp.json für alle Projekte und aus .cursor/mcp.json für ein einzelnes Projekt.

Verbinden

• Ergänzen Sie den Eintrag unten in ~/.cursor/mcp.json. Stehen dort schon Server, fügen Sie sallyport in mcpServers hinzu.
• Öffnen Sie Cursor Settings, suchen Sie sallyport im Bereich MCP und klicken Sie auf Connect. Ihr Browser öffnet Sallyport.
• Melden Sie sich an oder legen Sie ein Konto an, dann klicken Sie auf dem Zustimmungsbildschirm auf „Erlauben“.

{
  "mcpServers": {
    "sallyport": {
      "url": "https://mcp.sallyport.cloud/mcp"
    }
  }
}

„Erlauben“ legt einen Agenten mit dem Namen des Clients an. Der Agent eines Inhabers oder Admins startet mit allen Verbindungen des Arbeitsbereichs. Der eines Mitglieds startet ohne, und ein Admin fügt sie unter „Zugriff“ hinzu. Eine spätere Anmeldung kostet einen Klick auf „Neu verbinden“.

Mit Token verbinden

Ein Token passt zu einem Rechner, an dem sich niemand im Browser anmeldet. Cursor sendet ihn im Header, und die Konsole schreibt den Eintrag für Sie.

• Öffnen Sie in der Konsole Agenten, klicken Sie auf „Neuer Agent“, geben Sie einen Namen ein und klicken Sie auf „Agent erstellen“.
• Wählen Sie auf der Seite des Agenten unter „Diesen Agenten verbinden“ „Cursor“ und klicken Sie auf „Für Cursor kopieren“. Die Kopie enthält den Token, den Sie gerade auf dieser Seite erstellt haben, oder einen neuen.
• Fügen Sie sie in ~/.cursor/mcp.json ein. Stehen dort schon Server, ergänzen Sie den Eintrag sallyport in mcpServers.

{
  "mcpServers": {
    "sallyport": {
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": { "Authorization": "Bearer YOUR_AGENT_TOKEN" }
    }
  }
}

Ein Projekt, der Token außerhalb von git

Für ein einzelnes Projekt nehmen Sie .cursor/mcp.json. Cursor löst ${env:NAME} in Headern auf, also nennt die eingecheckte Datei eine Variable statt des Tokens.

{
  "mcpServers": {
    "sallyport": {
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": { "Authorization": "Bearer ${env:SP_AGENT_TOKEN}" }
    }
  }
}

Setzen Sie SP_AGENT_TOKEN in der Umgebung, mit der Cursor startet. Geben Sie jedem Repository einen eigenen Agenten, und das Journal zeigt, wer jeden Aufruf gemacht hat.

Wenn ein Aufruf auf einen Menschen wartet

Aufrufe laufen direkt durch, außer Sie haben „Bei jedem Aufruf fragen“ für eine Verbindung eingeschaltet, eine Klasse auf „Freigabe erforderlich“ gestellt oder ein Budget gesetzt. Sallyport hält einen wartenden Aufruf höchstens 4 Minuten, und höchstens 45 Sekunden, wenn der Client kein Fortschritts-Token sendet. Dann antwortet es mit approve_url und call_id.

Öffnen Sie den Link und antworten Sie, dann sagen Sie dem Agenten, er soll weitermachen. Er wiederholt den Aufruf mit derselben call_id und bekommt das Ergebnis, der Dienst wird also einmal aufgerufen.