API 레퍼런스: MCP

MCP 서버를 사용하면 AI 어시스턴트가 Model Context Protocol을 통해 ProcessMind와 상호작용할 수 있습니다. Streamable HTTP에서 JSON-RPC 2.0을 사용합니다. initialize을 보낸 다음 tools/list을 보내 도구 목록을 확인하세요. list_processes 같은 읽기 도구는 API 키에 read scope가 있을 때만 목록에 표시되며, 쓰기 도구에는 write scope가 필요합니다. tools/call을 사용해 인수와 함께 도구를 호출하세요. 메모리 도구(remember, recall, forget)를 사용하면 세션 간에 정보를 저장할 수 있습니다. 오래 실행되는 AI 생성 작업은 도구 호출별로 추적됩니다. _meta["io.modelcontextprotocol/related-task"]에 작업 참조를 첨부하면 ProcessMind가 호출 결과에 작업 상태를 포함합니다. tasks/list, tasks/get, tasks/cancel 확장 메서드는 제공되지 않습니다.

Model Context Protocol 서버 엔드포인트(Streamable HTTP 기반 JSON-RPC)

Streamable HTTP 기반 JSON-RPC 2.0: initialize, tools/list, tools/call, resources/list, resources/read, prompts/list. 읽기 도구에는 키의 read scope가, 쓰기 도구에는 write scope가 필요합니다. 도구 목록은 MCP 가이드에서 확인할 수 있습니다. x-api-key 또는 Authorization: Bearer <token>(OAuth 토큰 엔드포인트에서 발급한 토큰)으로 인증하세요.

엔드포인트: POST /v1/mcp/{tenantId}

인증: 테넌트 범위 API 키 · read scope · 초당 요청 20회 제한(최대 40회)

매개변수:

이름	유형	위치	필수	설명
tenantId	string	경로	예	형식: uuid

요청 본문:

MCP JSON-RPC 요청

{}

응답(200):

MCP JSON-RPC 응답

{
	"message": "string"
}

필드	유형	필수	설명
message	string	예

오류:

• 401 API 키가 없거나 유효하지 않거나 비활성화 또는 만료됨
• 403 API 키에 필요한 scope 또는 조직 액세스 권한이 없거나, 테넌트가 비활성 상태이거나, 요금제가 해당 파일 형식을 지원하지 않음

OAuth 2.1 인증 엔드포인트(PKCE), redirect_uri로 302 리디렉션하고 ?code=… 전달.

엔드포인트: GET /v1/mcp/{tenantId}/oauth/authorize

인증: 공개 엔드포인트, API 키 불필요 · 초당 요청 10회 제한(최대 20회)

매개변수:

이름	유형	위치	필수	설명
tenantId	string	경로	예	형식: uuid
client_id	string	쿼리	예
redirect_uri	string	쿼리	예	형식: uri
code_challenge	string	쿼리	예
code_challenge_method	S256	쿼리	아니요	허용 값: S256
state	string	쿼리	아니요

오류:

• 302 code와 state를 포함해 redirect_uri로 리디렉션
• 400 잘못된 요청: 유효하지 않은 필터 표현식, 모델이 없는 프로세스, 지원되지 않는 업로드 형식 또는 필수 필드 누락 등
• 401 API 키가 없거나 유효하지 않거나 비활성화 또는 만료됨

OAuth 2.0 토큰 엔드포인트(client_credentials 또는 authorization_code + PKCE)

엔드포인트: POST /v1/mcp/{tenantId}/oauth/token

인증: 공개 엔드포인트, API 키 불필요 · 초당 요청 5회 제한(최대 10회)

매개변수:

이름	유형	위치	필수	설명
tenantId	string	경로	예	형식: uuid

응답(200):

액세스 토큰

{
	"access_token": "string",
	"token_type": "Bearer",
	"expires_in": 0
}

필드	유형	필수	설명
access_token	string	예	POST /v1/mcp/{tenantId}에 사용하는 단기 Bearer JWT
token_type	Bearer	예	허용 값: Bearer
expires_in	number	예

오류:

• 400 잘못된 요청: 유효하지 않은 필터 표현식, 모델이 없는 프로세스, 지원되지 않는 업로드 형식 또는 필수 필드 누락 등
• 401 API 키가 없거나 유효하지 않거나 비활성화 또는 만료됨
• 403 API 키에 필요한 scope 또는 조직 액세스 권한이 없거나, 테넌트가 비활성 상태이거나, 요금제가 해당 파일 형식을 지원하지 않음