학습 결과: 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에는 영문 설명서 전체가
마크다운으로 들어 있습니다. 영문 페이지마다
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_run은 호출마다 설치된 같은 토파즈 실행 파일의 숨은 작업자를 새로
시작하고 아무 기능도 주지 않는 호스트를 사용합니다. 파일 시스템과 네트워크,
탐색, 콜백, 구성 요소와 폴백 경로가 없습니다. 동시에 두 호출만 받고 대기열은
두지 않으며 5초 실행 시간과 1 MiB 응답 한도를 적용합니다. 취소되거나 한도를
넘긴 작업자는 응답 전에 종료하고 회수합니다. 제출한 소스는 표준 입력으로만
전달되고 기록되거나 보관되지 않습니다.
이 작성 경계는 토파즈가 지원하는 모든 네이티브 타깃에 들어 있습니다. 제한
없는 일반 topaz run은 아니지만 운영체제 샌드박스나 CPU와 RSS의 hard bound도
아닙니다. 적대적인 코드를 제출하지 마세요.
기계가 읽는 서술자
클라이언트와 크롤러는 서버 설명을 직접 읽을 수 있습니다.
https://topaz.ooo/mcp.json여기에는 네 도구와 입력, 내장 명령, 자원 경계와 설치 후 확인값이 구조화되어 있습니다.
현재 상태
토파즈 5.18.1은 네이티브 topaz 실행 파일에 MCP 서버와 작업자를 함께
담습니다. 토파즈를 설치하면 MCP 서버가 함께 옵니다. 별도 아카이브와 체크섬,
서버·작업자·승인 파일 경로는 없습니다.
설치하고 연결하기
토파즈를 설치한 뒤 다음 로컬 stdio 명령을 설정합니다.
{
"command": "topaz",
"args": ["mcp", "serve"]
}
연결이 끝나면 클라이언트에는 topaz_spec, topaz_examples,
topaz_check, topaz_run 네 도구가 보여야 합니다.
mcp.json의 verification 블록에는 알려진
참조 절과 예제 개념, 오류 없는 검사 소스, 값이 42인 순수 실행 예제가
들어 있습니다. 설정만 믿지 않고 실제 서버를 확인할 때 이 값을 사용합니다.
이어갈 준비가 된 시점
정확한 참조를 찾고 컴파일러 진단으로 소스를 고친 뒤, 설치된 무권한 작업자로 순수 프로그램을 실행할 수 있으면 됩니다.
프로그램이 무엇에 닿을 수 있고 없는지는 상호 운용 개요를, 어시스턴트가 찾아보게 될 형태들은 문법 한눈에 보기를 보세요.