MCP sloupec

Přehled MCP sloupce

Tato příručka je Superroute MCP sloupec v Developer Center: oba servery, bezpečnost agentů a živý katalog nástrojů.

• User MCP — objednávky, trasy, štítky, digesty pro ops/support agenty — https://api.superlabel.ca/mcp
• Developer MCP — příručky, webhooky a ukázková API pro integrátory — https://api.superlabel.ca/mcp/developer
• Bezpečnost: connection Bearer, profily/scopes, confirm pro high-risk nástroje
• Fronta lidských schválení (propose_write + /mcp-approvals)

Co je MCP?

Model Context Protocol (MCP) je otevřený standard, který umožňuje AI asistentům jako Claude, Cursor a ChatGPT komunikovat s externími nástroji a službami. Umožňuje vašemu AI provádět skutečné akce — jako je sledování zásilky — přímo v konverzaci.

Konfigurací MCP serveru Superroute získá váš AI asistent přístup k logistickým nástrojům bez opuštění vašeho pracovního postupu.

Dva MCP servery

Vyberte správný server. Nedávejte bezobslužným agentům Developer server s plným přístupem.

Rychlý start

Veřejné nástroje jako sledování zásilek fungují bez autentizace. Přidejte tuto konfiguraci do svého MCP klienta:

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp"
    }
  }
}

Autentizovaný přístup

Pro použití nástrojů vyžadujících uživatelská oprávnění přidejte svůj API Bearer token do konfigurace:

Tokeny dávejte vždy do hlaviček MCP připojení — nikdy do argumentů nástrojů ani promptů.

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

Jak získat API token

Zavolejte přihlašovací endpoint se svými přihlašovacími údaji:

curl -X POST https://api.superlabel.ca/api/v1/user/login \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "password": "your-password"}'

Odpověď bude obsahovat váš přístupový token:

{
  "access_token": "eyJ0eXAiOiJKV1Qi...",
  "token_type": "Bearer",
  "expires_at": "2026-02-20 00:00:00"
}

Použijte hodnotu access_token v hlavičce Authorization vaší MCP konfigurace.

Bezpečnostní model agentů

User MCP je pro least privilege. Vytvářejte tokeny s MCP profilem (výchozí ops jen pro čtení) nebo hlavičkami.

Profily (X-MCP-Profile)

Pojmenované balíčky scope. Pro bezobslužné agenty ops-readonly nebo support.

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp",
      "headers": {
        "Authorization": "Bearer <ops-readonly-token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

Volitelné hlavičky

High-risk potvrzení

Tyto nástroje vyžadují confirm=true při tools/call (nebo frontu schválení):

• cancel_order
• bulk_create_orders
• reroute_to_address
• build_route
• hold_order
• release_order
• approve_pending_write

Fronta lidských schválení

Bezobslužní agenti navrhují zápisy; člověk schvaluje.

1. Agent: propose_write nebo X-MCP-Require-Approval: 1
2. Člověk: MCP Approvals v appce nebo list_pending_approvals
3. Člověk: approve_pending_write s confirm=true nebo reject_pending_write

Cesta Web UI (vyžaduje přihlášení): /mcp-approvals

Developer MCP autentizace

Preferujte Authorization: Bearer na připojení. api_token v toolu je zastaralý a končí po 2026-12-31.

Dostupné nástroje

Následující nástroje jsou momentálně dostupné na MCP serveru: 47 živých nástrojů ze serverového katalogu

Tato tabulka se generuje z UserMcpToolCatalog za běhu a je synchronizovaná s tools/list.

Nastavení pro klienta

Vyberte svého AI klienta níže pro přizpůsobené pokyny k nastavení:

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp"
    }
  }
}

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

{
  "mcpServers": {
    "super-label": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp"
    }
  }
}

{
  "mcpServers": {
    "super-label": {
      "serverUrl": "https://api.superlabel.ca/mcp"
    }
  }
}

Technické detaily

• Protokol: JSON-RPC 2.0
• Doprava: HTTP POST (Streamable HTTP)
• Limit rychlosti: 60 požadavků za minutu
• Typ obsahu: application/json
• Koncový bod: https://api.superlabel.ca/mcp
• Verze protokolu: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05
  Obě generace protokolu jsou obsluhovány na stejném koncovém bodě: klienti, kteří začínají výměnou initialize, a bezstavoví klienti, kteří verzi uvádějí v každém požadavku. Server nikdy nevydává identifikátor relace.
• Zjišťování OAuth: https://api.superlabel.ca/.well-known/oauth-protected-resource
  Neověřený požadavek vrátí 401 s hlavičkou WWW-Authenticate odkazující na dokument metadat chráněného zdroje.