KI-Agenten arbeiten in Qasha, in Ihrem Namen.

Verbinden

Adresse

Ihre Qasha-Adresse, gefolgt von /api/mcp. Sie steht kopierbereit unter „Settings → API tokens & agents“.

Transport

Streamable HTTP. JSON-RPC-2.0-Nachrichten, einzeln oder als Batch, werden per POST gesendet, und die Antworten kommen als JSON zurück.

Authentifizierung

Ein persönliches Token, gesendet als Authorization: Bearer <token>. Siehe persönliche Tokens.

Protokollversionen

2025-06-18 (Standard), 2025-03-26 und 2024-11-05.

Methoden

initialize, ping, tools/list und tools/call.

Mit Claude Code:

claude mcp add --transport http qasha \
  https://<your-qasha-address>/api/mcp \
  --header "Authorization: Bearer $QASHA_TOKEN"

Clients, die ihre Server aus einer JSON-Datei lesen, erhalten die Adresse und einen Header. Üblich ist diese Form:

{
  "mcpServers": {
    "qasha": {
      "url": "https://<your-qasha-address>/api/mcp",
      "headers": { "Authorization": "Bearer <your personal token>" }
    }
  }
}

Mit curl ausprobieren

Der Server braucht keine Sitzung, eine einzelne Anfrage genügt, um die Tools zu sehen:

curl -s https://<your-qasha-address>/api/mcp \
  -H "Authorization: Bearer $QASHA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Dann rufen Sie eines auf. Jedes Tool antwortet mit einem einzelnen Textelement, das sein Ergebnis als JSON enthält:

curl -s https://<your-qasha-address>/api/mcp \
  -H "Authorization: Bearer $QASHA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"search_documents","arguments":{"status":"sent","limit":5}}}'

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{ "type": "text", "text": "[ { \"id\": \"…\", \"title\": \"Master services agreement\", \"status\": \"sent\", … } ]" }]
  }
}

Tools

Zwölf Tools; der Server beschreibt sie dem Agenten auf Englisch. Fett gedruckte Eingaben sind Pflicht.

status (Dokumente)

draft, sent, viewed, signed, declined oder void.

status (Rechnungen)

draft, sent, partially_paid, paid, overdue oder void.

kind

quote oder contract.

content

Markdown: ## Überschriften, Absätze, - Listen und **fett**.

signers

Wer unterschreibt, in Reihenfolge: jeweils mit Name und E-Mail, optional mit Reihenfolge und ob die Person intern ist (aus Ihrem Team).

items

Mindestens eine Position, jeweils mit description und unit_amount (in Haupteinheiten), optional mit quantity und tax_percent.

Ein Dokument entwerfen

Ein Agent entwirft mit create_document, und nichts erreicht einen Kunden, bevor er send_for_signature aufruft. Ein so erstellter Entwurf gehört der Person, wie jeder Entwurf, den sie selbst schreibt.

{
  "name": "create_document",
  "arguments": {
    "title": "Order form: Northwind",
    "kind": "quote",
    "content": "## Services\nImplementation and support, as discussed.\n\n**Total:** $12,000",
    "signers": [
      { "name": "Ada Obi", "email": "ada@northwind.example", "order": 1 },
      { "name": "Sam Reyes", "email": "sam@yourcompany.example", "order": 2, "internal": true }
    ]
  }
}

Was ein Agent darf

• Nur, was die Person darf. Jedes Tool ist eine gewöhnliche Anfrage der Person, deren Token der Agent trägt, über dieselbe API mit denselben Regeln und Zugriffen; der Agent sieht also ihre Dokumente und Kunden und keine anderen.
• Erst Entwürfe. Ein Dokument oder eine Rechnung zu erstellen, erzeugt einen Entwurf. Das Versenden ist ein eigenes Tool, das der Agent aufrufen muss.
• Höfliche Erinnerungen. remind_signers erreicht jede unterzeichnende Person höchstens einmal am Tag.
• Ihr Modell für Prüfungen. review_document nutzt den Assistenten, den Ihr Workspace eingerichtet hat.
• Sofort abgeschaltet. Widerrufen Sie das Token, und die nächste Anfrage wird abgelehnt.

Fehler