AI агенти и MCP

Поврзи AI агент со објавените водичи на Official Translator. Содржината се бара кога агентот ќе повика MCP алатка; не се испраќа автоматски до OpenAI и не бара посебни копии на статиите.

Јавен read-only MCP endpoint

https://officialtranslator.pro/mcp

Транспорт: Streamable HTTP. Не бара најава и враќа само објавени водичи.

Достапни алатки

`search_published_guides`

Пребарува поим во објавените македонски и англиски водичи. Прифаќа query, изборен филтер language (mk или en) и изборен limit од 1 до 10. Резултатите содржат наслов, опис, јазик, датум на ажурирање и URL.

`fetch_published_guide`

Со slug го враќа целиот текст, FAQ, јазикот, датумот на ажурирање и јавниот URL на објавен водич.

Како агентот треба да одговара

Прво пребарај со зборовите на корисникот.
Ако нема добар резултат, пробај пократок поим или пребарај и на другиот јазик.
Отвори го најрелевантниот водич пред да одговориш.
Одговори според водичот и цитирај го неговиот URL. За тековни услови, наведи ги и официјалните извори што ги цитира статијата.
Не измислувај услови и не се потпирај само на меморијата на моделот. Ако нема соодветен водич, кажи го тоа.

Пример за OpenAI Responses API

Додај го MCP серверот во tools на барањето од твојот OpenAI клиент:

{
  "type": "mcp",
  "server_label": "official_translator",
  "server_description": "Search and read published Official Translator guides.",
  "server_url": "https://officialtranslator.pro/mcp",
  "allowed_tools": [
    "search_published_guides",
    "fetch_published_guide"
  ],
  "require_approval": "never"
}

require_approval: "never" важи само за овие јавни read-only алатки. Не испраќај приватни документи, барања за понуда или лични податоци преку нив.

Погледни го и официјалното OpenAI упатство за MCP во Responses API. За машински читливи насоки отвори го llms.txt.

Поврзување со други агенти

Codex CLI

codex mcp add officialTranslator --url https://officialtranslator.pro/mcp
codex mcp list

Claude Code

claude mcp add --transport http officialTranslator https://officialtranslator.pro/mcp
claude mcp list

Cursor

Додај го ова во конфигурацијата mcp.json на Cursor:

{
  "mcpServers": {
    "officialTranslator": {
      "url": "https://officialtranslator.pro/mcp"
    }
  }
}

Командите се локални конфигурации на агентот; тие не поврзуваат chatbot на Official Translator со тие сервиси. Проверувај ги и Codex, Claude Code и Cursor документациите за промени во конфигурацијата.

Јавен MCP Registry

Official Translator Public Guides е објавен во јавниот MCP Registry под името io.github.jovan1301/official-translator-guides. Записот го наведува стабилниот продукциски endpoint https://officialtranslator.pro/mcp, Streamable HTTP транспортот и двете read-only алатки.

English

For AI agents

Connect to the published guides through the read-only Streamable HTTP MCP endpoint: https://officialtranslator.pro/mcp. The tools are search_published_guides and fetch_published_guide. Only published public articles are returned.

Search first, fetch the most relevant guide, answer from its content, and cite its public URL. If needed, retry in the other language. Do not invent requirements or rely only on model memory. The MCP server does not connect to an OpenAI chatbot by itself; the agent host must configure the server URL in its MCP tools.

See the machine-readable agent instructions and the OpenAI Responses API MCP guide.

Other agent clients

Codex CLI: codex mcp add officialTranslator --url https://officialtranslator.pro/mcp

Claude Code: claude mcp add --transport http officialTranslator https://officialtranslator.pro/mcp

For Cursor, add {"mcpServers":{"officialTranslator":{"url":"https://officialtranslator.pro/mcp"}}} to mcp.json. See the official Codex, Claude Code, and Cursor documentation for current setup details.

Official Translator Public Guides is listed in the public MCP Registry as io.github.jovan1301/official-translator-guides. The listing points to the stable production https://officialtranslator.pro/mcp endpoint and includes its Streamable HTTP transport and two read-only tools.