MCP

Vodič za konfiguraciju MCP servera

Povežite svog AI asistenta sa Superroute koristeći Model Context Protocol (MCP) za praćenje paketa i više.

MCP track_package(tracking_number) Tool
RPC tools/list JSON-RPC 2.0
RPC tools/call JSON-RPC 2.0
Documentation

Šta je MCP?

Model Context Protocol (MCP) je otvoreni standard koji omogućava AI asistentima kao što su Claude, Cursor i ChatGPT da komuniciraju sa spoljnim alatima i servisima. Omogućava vašem AI da izvršava stvarne radnje — kao što je praćenje paketa — direktno u razgovoru.

Konfigurisanjem Superroute MCP servera, vaš AI asistent dobija pristup logističkim alatima bez napuštanja radnog toka.

Brzi početak

Javni alati poput praćenja paketa rade bez autentifikacije. Dodajte ovu konfiguraciju svom MCP klijentu:

JSON
{
  "mcpServers": {
    "superroute": {
      "type": "url",
      "url": "https://api.superroute.ca/mcp"
    }
  }
}
Isprobajte! Nakon podešavanja, pitajte svog AI asistenta: „Prati paket SR100012345"

Autentifikovan pristup

Da biste koristili alate koji zahtevaju korisničke dozvole, dodajte svoj API Bearer token u konfiguraciju:

JSON
{
  "mcpServers": {
    "superroute": {
      "type": "url",
      "url": "https://api.superroute.ca/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

Kako dobiti API token

Pozovite endpoint za prijavu sa vašim akreditivima:

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

Odgovor će sadržati vaš pristupni token:

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

Koristite vrednost access_token u Authorization zaglavlju vaše MCP konfiguracije.

Dostupni alati

Sledeći alati su trenutno dostupni na MCP serveru:

Alat Autentifikacija Opis
track_package Javno Pratite paket prema broju za praćenje. Vraća status isporuke, vremensku liniju događaja praćenja i dokaz o isporuci ako je dostupan.

Više alata će biti dodato vremenom. Autentifikovani alati će se pojaviti samo kada se pruži važeći token.

Podešavanje po klijentu

Izaberite svog AI klijenta ispod za prilagođena uputstva za podešavanje:

Claude Code

Claude Code čita MCP konfiguraciju iz .mcp.json datoteke u korenu projekta ili home direktorijumu.

  1. Kreirajte .mcp.json datoteku u korenu projekta (ili ~/.claude/.mcp.json za globalni pristup).
  2. Dodajte sledeću konfiguraciju:
.mcp.json
{
  "mcpServers": {
    "superroute": {
      "type": "url",
      "url": "https://api.superroute.ca/mcp"
    }
  }
}

Za korišćenje autentifikovanih alata, dodajte polje headers:

.mcp.json (sa autentifikacijom)
{
  "mcpServers": {
    "superroute": {
      "type": "url",
      "url": "https://api.superroute.ca/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-token>"
      }
    }
  }
}

Cursor

Cursor podržava MCP servere kroz svoju ugrađenu konfiguraciju.

  1. Kreirajte .cursor/mcp.json datoteku u korenu projekta.
  2. Dodajte sledeću konfiguraciju:
  3. Restartujte Cursor da biste učitali novi MCP server.
.cursor/mcp.json
{
  "mcpServers": {
    "superroute": {
      "type": "url",
      "url": "https://api.superroute.ca/mcp"
    }
  }
}

Windsurf

Windsurf koristi globalnu MCP konfiguracionu datoteku.

  1. Uredite ~/.codeium/windsurf/mcp_config.json (kreirajte ako ne postoji).
  2. Dodajte sledeću konfiguraciju:
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "superroute": {
      "serverUrl": "https://api.superroute.ca/mcp"
    }
  }
}

ChatGPT

ChatGPT podržava MCP konekcije za Plus, Pro i Team korisnike.

  1. Otvorite ChatGPT i idite na Podešavanja.
  2. Navigirajte do odeljka „Povezane aplikacije" ili „Alati".
  3. Dodajte novi MCP server sa URL-om endpointa prikazanim iznad.
MCP podrška ChatGPT-a može varirati u zavisnosti od vašeg plana i regiona. Pogledajte OpenAI dokumentaciju za najnovija uputstva.

Tehnički detalji