TracePass
Започнете
Справочник

MCP сървър

MCP сървър — AI асистенти (Claude, Cursor, IDE) управляват продукти, паспорти, EPCIS събития. Хостван endpoint или локален npm пакет.

Изтегли OpenAPI 3.1JSON огледало →

MCP сървърът на TracePass позволява на един AI асистент да управлява платформата TracePass директно — да изброява и създава продукти, да изгражда и одитира цифрови продуктови паспорти, да задава икономически оператори и да чете или заснема GS1 EPCIS събития във веригата на доставки. Той говори целия Model Context Protocol: tools, resources и prompts. Свържете хостван endpoint или го пуснете локално чрез npx — и двата начина се удостоверяват със същите tp_ API ключове като v1 API. Изходен код в GitHub, публикуван като tracepass-mcp-server в npm.

Какво представлява

MCP е отворен протокол, който позволява на AI асистент да извиква външни tools и да чете външни данни през един стандартен интерфейс. MCP сървърът на TracePass е тънък adapter без състояние пред v1 API на TracePass — той няма собствена база данни; всяко извикване на tool и всяко четене на resource минават директно през същото API, което използват и другите ви интеграции, така че удостоверяване, ограничения по план и лимити на честотата се държат по идентичен начин. Има два начина да го свържете. Хостваният сървър работи на https://ai.tracepass.eu/mcp през HTTP — няма какво да се инсталира, винаги е актуален. Локалният сървър е npm пакетът tracepass-mcp-server, пуснат като подпроцес от вашия MCP клиент и говорещ MCP през stdio.

Свързване (хостван)

Насочете вашия MCP клиент към хоствания endpoint и подайте вашия API ключ като Bearer token. Генерирайте ключ в таблото от Developer → API Keys — това е същият tp_ ключ, който използва v1 API. Добавете този блок към MCP конфигурацията на вашия клиент:

json
{
  "mcpServers": {
    "tracepass": {
      "url": "https://ai.tracepass.eu/mcp",
      "headers": { "Authorization": "Bearer tp_YOUR_KEY" }
    }
  }
}

Свързване (локално / npx)

За локална настройка вашият MCP клиент пуска npm пакета като подпроцес и говори с него през stdio. Няма нужда от предварителна инсталация — npx изтегля tracepass-mcp-server при първото пускане. API ключът се подава през променливата на средата TRACEPASS_API_KEY вместо през header:

json
{
  "mcpServers": {
    "tracepass": {
      "command": "npx",
      "args": ["-y", "tracepass-mcp-server"],
      "env": {
        "TRACEPASS_API_KEY": "tp_YOUR_KEY"
      }
    }
  }
}

Tools

Операциите на v1 API на TracePass са групирани в пет tools. Всеки приема action плюс специфични за действието args, така че асистентът избира tool по област, а операцията — по action:

ToolДействия
tracepass_productslist, get, create, update
Операции с каталога — преглеждане, четене и създаване или актуализиране на продукти.
tracepass_passportslist, get, get_by_serial, create, suspend, archive, get_qr
Жизненият цикъл на паспорта — изброяване и четене на паспорти, търсене по сериен номер, създаване, спиране, архивиране и извличане на QR кода.
tracepass_passport_fieldsupdate
Актуализиране на отделни полета на шаблон в паспорт.
tracepass_passport_partiesset, remove
Задаване или премахване на икономически оператори (производител, вносител, рециклатор и т.н.) в паспорт.
tracepass_epcisexport, capture, capture_job, query
Четене и запис на GS1 EPCIS 2.0 събития във веригата на доставки — експорт на историята на събитията на паспорт, заснемане на нови събития, изпълнение на capture задача и заявки към хранилището на събития.

Resources

Resources са данни само за четене, които потребителят прикача като контекст на разговора, адресирани чрез tracepass:// URI. Един е статичен resource, останалите са resource templates, които клиентът допълва с id:

  • tracepass://products
  • tracepass://product/{id}
  • tracepass://passport/{id}
  • tracepass://passport/{id}/epcis

Prompts

Prompts са повтаряеми DPP работни процеси, които MCP клиентът показва на потребителя, обикновено като slash-команди. Всеки засява разговора така, че асистентът да изпълни задачата по начина, по който TracePass предвижда — например винаги да потвърждава, преди да създаде платен паспорт:

  • audit_passport
  • onboard_product
  • review_epcis_events