Результат: вы сориентируете ассистента, умеющего получать URL или запускать инструменты, на работу с этим языком.
Что нужно знать: для первого раздела ничего. Серверу MCP требуется инструментарий, установленный согласно разделу Первая программа.
Начните с одного запроса
Для ассистента, способного запрашивать URL, но не имеющего настроенных инструментов, наиболее доступным общим интерфейсом служит один автономный файл.
https://topaz.ooo/agents.mdВ нём описаны структура файла, языковые формы, границы хоста и профиля продукта, а также перечень несуществующих форм, особо важный для моделей, уже знающих другие языки. Он предостерегает от использования Vec<T>, async, try, классового синтаксиса и null как универсального отсутствия, сохраняя при этом поддерживаемую форму границы данных T | null. Подобные явные различия не дают уверенной догадке превратиться в неверный исходный код.
Рядом доступны и другие поверхности для машинного чтения.
https://topaz.ooo/llms.txt служит компактным указателем, а
https://topaz.ooo/llms-full.txt содержит всё англоязычное руководство в
Markdown. Для каждой англоязычной страницы также предусмотрен адрес
https://topaz.ooo/docs/<slug>.md. В его frontmatter сохраняются заголовок,
исходный маршрут и охваченные разделы спецификации.
https://topaz.ooo/version.json сообщает версию текущего ответа.
Если вы настраиваете ассистента для кого-то другого, передать ему этот один URL — это и есть вся настройка.
Какую задачу решают инструменты
Загрузка файла направляет ассистента к правильным формам. Однако она не показывает, компилируется ли написанная им программа на самом деле.
Ассистент, пишущий на незнакомом языке, делает одно из двух: либо читает документацию и угадывает, либо пишет код, получает точное указание на ошибку и исправляет её. Второй цикл даёт работающий код даже при скудной документации. Первый же создаёт убедительный текст, который не компилируется. Одно лишь справочное руководство оставляет ассистента в первом цикле, тогда как проверяющий инструмент переводит его во второй.
Четыре опубликованных инструмента
| Инструмент | На какой вопрос отвечает |
|---|---|
topaz_spec | Какова точная форма для этой части языка? |
topaz_examples | Покажи проверенный код для этого понятия. |
topaz_check | Правильно ли то, что я только что написал, и если нет, то где именно? |
topaz_run | Какой результат даёт программа в среде без полномочий? |
topaz_check без изменений возвращает диагностику компилятора, её код и позицию в исходном тексте. topaz_run сначала выполняет аналогичную проверку, а затем для каждого вызова запускает новый рабочий процесс. Оба инструмента указывают установленный инструментарий и выбранный компилятор, поэтому ассистент исправляет код по фактическому результату, а не по пересказу.
topaz_check принимает необязательный вход profile: "agent-pack". Вызов с профилем прогоняет тот же установленный компилятор по правилам Agent Pack. Ответ имеет схему topaz.mcp-check-result/v2 и несёт profile: "agent-pack". Имя правила, отклонившего код, приходит в data.profileRule каждой диагностики. Без profile ответ остаётся прежним, со схемой topaz.mcp-check-result/v1.
Граница выполнения
Каждый вызов topaz_run запускает новый скрытый рабочий процесс из того же установленного файла Топаза и хост без полномочий. У него нет доступа к файловой системе и сети, механизмам обнаружения, callback, компонентам и резервному маршруту. Сервер допускает два одновременных запуска без очереди, ограничивает время пятью секундами и ответ одним MiB, а отменённый процесс завершает и утилизирует. Исходный код передаётся через stdin, не журналируется и не сохраняется.
Эта авторская граница входит во всё поддерживаемые нативные цели Топаза. Это не обычный неограниченный topaz run, но и не песочница операционной системы или жёсткий предел CPU и RSS. Не отправляйте в неё враждебный код.
Дескриптор для машинного чтения
Клиенты и поисковые роботы могут прочитать описание сервера напрямую.
https://topaz.ooo/mcp.jsonВ нём в структурированном виде перечислены четыре инструмента, их входные данные, встроенная команда, пределы ресурсов и значения для проверки установки.
Текущее состояние
Топаз 5.18.1 включает сервер MCP и рабочий процесс непосредственно в нативный исполняемый файл topaz. Установка Топаза сразу развёртывает сервер MCP. Отдельные архивы, контрольные суммы и пути к серверу, рабочему процессу или разрешениям отсутствуют.
Установка и подключение
Установите Топаз и настройте следующую локальную команду stdio.
{
"command": "topaz",
"args": ["mcp", "serve"]
}После подключения клиент должен обнаружить ровно четыре инструмента: topaz_spec, topaz_examples, topaz_check и topaz_run. Блок verification в mcp.json содержит известный раздел справочника, понятие для поиска примера, исходник без ошибок и чистый запуск со значением 42. Эти значения позволяют проверить реально подключённый сервер, а не доверять одной лишь конфигурации.
Готовы двигаться дальше, если
Вы готовы двигаться дальше, если умеете находить точную справку, исправлять код по диагностике компилятора и выполнять чистую программу во встроенном рабочем процессе без полномочий.
О том, до чего программа может и не может дотянуться, читайте в разделе Границы интеграции. Формы, которые будет искать ассистент, собраны в разделе Краткий обзор синтаксиса.