개발자

개발자 도구 · MCP

AI 에이전트에서 Tritonium 사용하기

Tritonium은 원격 Model Context Protocol(MCP) 서버를 운영합니다. Tritonium 계정으로 AI 에이전트에 로그인하거나 범위가 지정된 API 키를 제공하면, 에이전트가 앱, 리뷰, 인사이트 및 평점 예측을 읽고 팀의 승인을 기다리는 답변 초안을 준비할 수 있습니다.

엔드포인트

연결 세부 정보

모든 클라이언트가 동일한 URL에 연결됩니다. MCP 로그인을 지원하는 클라이언트는 추가 설정이 필요 없으며, 나머지는 Tritonium API 키를 보냅니다.

엔드포인트
https://api.tritonium.com/mcp
전송
JSON 응답이 있는 Streamable HTTP입니다. SSE 스트림이나 세션이 없습니다.
프로토콜 버전
MCP 2026-07-28와 initialize 기반의 이전 리비전 2025-03-26~2025-11-25를 같은 URL에서 지원합니다.
로그인
MCP 인증 사양에서 설명하는 OAuth 2.1 with PKCE를 사용합니다. 자격 증명 없는 요청은 https://api.tritonium.com/.well-known/oauth-protected-resource/mcp를 가리키는 401 응답을 받습니다. 인증 서버의 메타데이터는 https://api.tritonium.com/.well-known/oauth-authorization-server에 있습니다.
API 키
Tritonium API 키를 Authorization: Bearer <key> 형식 또는 X-API-Key 헤더로 보냅니다. 대시보드 세션 토큰은 허용되지 않습니다.
상태 확인
https://api.tritonium.com/mcp/health

빠른 시작

3단계로 설정하기

에이전트에 Tritonium을 추가하고, 로그인한 후 에이전트가 할 수 있는 작업을 승인한 다음, 에이전트에 질문을 하세요.

  1. 에이전트에 Tritonium 추가

    아래의 각 설정은 URL로 서버를 추가합니다. 에이전트가 처음 연결할 때 Tritonium에 로그인하도록 요청합니다. 모든 클라이언트는 대신 API 키를 사용하는 방법도 보여줍니다.

    Claude Code

    터미널
    claude mcp add --transport http --scope user tritonium https://api.tritonium.com/mcp

    그런 다음 Claude Code에서 /mcp를 실행하고, tritonium을 선택한 후 로그인하세요. 터미널에서 claude mcp login tritonium을 실행하면 동일합니다. SSH를 통해서는 --no-browser를 추가하세요. 출력된 링크를 자신의 컴퓨터에서 열고, 승인한 후 브라우저가 이동한 주소를 터미널에 붙여넣으세요.

    대신 API 키 사용

    먼저 키를 만들고 API 키에서 설명한 대로 TRITONIUM_API_KEY 환경 변수에 저장하세요.

    터미널
    claude mcp add --transport http --scope user tritonium https://api.tritonium.com/mcp --header 'Authorization: Bearer ${TRITONIUM_API_KEY}'

    작은따옴표를 사용하면 저장된 구성에 ${TRITONIUM_API_KEY}이 그대로 유지되며, Claude Code는 연결할 때 이 변수를 읽습니다. claude mcp list로 연결을 확인하세요.

    Codex

    터미널
    codex mcp add tritonium --url https://api.tritonium.com/mcp

    Codex는 서버가 로그인을 지원함을 감지하고 브라우저를 엽니다. 서버가 제공하는 모든 권한을 요청하므로, 에이전트가 필요하지 않은 권한은 승인하기 전에 선택을 해제하세요. 나중에 다시 로그인하려면 codex mcp login tritonium을 실행하세요.

    대신 API 키 사용

    먼저 키를 만들고 API 키에서 설명한 대로 TRITONIUM_API_KEY 환경 변수에 저장하세요.

    터미널
    codex mcp add tritonium --url https://api.tritonium.com/mcp --bearer-token-env-var TRITONIUM_API_KEY

    Codex는 TRITONIUM_API_KEY 환경 변수에서 키를 읽습니다.

    Cursor

    프로젝트의 .cursor/mcp.json에 또는 모든 프로젝트에 대해 ~/.cursor/mcp.json에 이를 추가하세요. 그런 다음 서버를 승인하고 Cursor CLI로 로그인하세요.

    mcp.json
    {
      "mcpServers": {
        "tritonium": {
          "url": "https://api.tritonium.com/mcp"
        }
      }
    }
    터미널
    cursor-agent mcp enable tritonium
    cursor-agent mcp login tritonium

    Cursor CLI는 http://localhost:8787/callback에서 브라우저를 기다리므로 실행하는 컴퓨터에서 포트 8787이 비어 있어야 합니다. SSH를 통해서는 ssh -L 8787:localhost:8787 <host>로 해당 포트를 포워드하세요. Cursor CLI가 같은 힌트를 출력합니다.

    대신 API 키 사용

    먼저 키를 만들고 API 키에서 설명한 대로 TRITONIUM_API_KEY 환경 변수에 저장하세요.

    프로젝트에서는 .cursor/mcp.json에, 모든 프로젝트에서 사용하려면 ~/.cursor/mcp.json에 추가하세요.

    mcp.json
    {
      "mcpServers": {
        "tritonium": {
          "url": "https://api.tritonium.com/mcp",
          "headers": { "Authorization": "Bearer ${env:TRITONIUM_API_KEY}" }
        }
      }
    }

    Cursor는 환경에서 ${env:TRITONIUM_API_KEY}를 채웁니다. Cursor가 인증 오류를 보고하거나 로그인을 제안하면, 키를 사용할 수 없었을 수 있습니다. 변수가 설정되어 있고 키가 여전히 활성 상태인지 확인하세요.

    GitHub Copilot CLI

    터미널
    copilot mcp add --transport http tritonium https://api.tritonium.com/mcp

    그 다음 copilot을 시작하고 /mcp auth tritonium를 실행하세요. 로그인은 대화형 세션에서만 시작되며 copilot -p에서는 시작되지 않습니다. Copilot이 그 후에도 서버에 인증이 필요하다고 표시하면 copilot을 다시 시작하세요. 그러면 저장된 로그인을 사용하며 copilot -p에서도 작동합니다.

    대신 API 키 사용

    먼저 키를 만들고 API 키에서 설명한 대로 TRITONIUM_API_KEY 환경 변수에 저장하세요.

    ~/.copilot/mcp-config.json에 이를 추가하세요.

    mcp-config.json
    {
      "mcpServers": {
        "tritonium": {
          "type": "http",
          "url": "https://api.tritonium.com/mcp",
          "headers": { "Authorization": "Bearer ${TRITONIUM_API_KEY}" },
          "tools": ["*"]
        }
      }
    }

    Copilot은 환경에서 ${TRITONIUM_API_KEY}를 채웁니다.

    Grok CLI

    터미널
    grok mcp add tritonium https://api.tritonium.com/mcp

    그 다음 grok을 시작하고 /mcps를 열어 tritonium을 선택한 후 i를 눌러 로그인하세요.

    대신 API 키 사용

    먼저 키를 만들고 API 키에서 설명한 대로 TRITONIUM_API_KEY 환경 변수에 저장하세요.

    ~/.grok/config.toml에 이를 추가하세요.

    config.toml
    [mcp_servers.tritonium]
    url = "https://api.tritonium.com/mcp"
    bearer_token_env_var = "TRITONIUM_API_KEY"

    Grok은 TRITONIUM_API_KEY 환경 변수에서 키를 읽습니다.

    Antigravity

    터미널
    agy mcp add tritonium https://api.tritonium.com/mcp

    그 다음 agy를 시작하고 /mcp를 열어 tritonium을 선택한 후 로그인하세요. 승인 후 브라우저에 코드가 있는 Antigravity 페이지가 표시됩니다. 해당 코드를 agy에 붙여넣으세요. 저장된 로그인은 agy --print에서도 작동합니다.

    대신 API 키 사용

    먼저 키를 만들고 API 키에서 설명한 대로 TRITONIUM_API_KEY 환경 변수에 저장하세요.

    ~/.gemini/config/mcp_config.json에 추가하고 자리 표시자를 키로 바꾸세요.

    mcp_config.json
    {
      "mcpServers": {
        "tritonium": {
          "serverUrl": "https://api.tritonium.com/mcp",
          "headers": { "Authorization": "Bearer trtn_live_your_key" }
        }
      }
    }

    Antigravity는 헤더의 환경 변수를 확장하지 않으므로 키 자체가 이 파일에 저장됩니다. 파일을 비공개로 유지하고(chmod 600) 버전 관리에서 제외하세요.

    OpenClaw

    터미널
    openclaw mcp set tritonium '{"url":"https://api.tritonium.com/mcp","transport":"streamable-http","auth":"oauth"}'
    openclaw mcp login tritonium

    OpenClaw는 http://127.0.0.1:8989/oauth/callback에서 브라우저를 기다립니다. 브라우저가 도달할 수 없는 경우(예: SSH를 통해), OpenClaw가 출력하는 openclaw mcp login tritonium --code <code> 명령으로 완료하세요.

    대신 API 키 사용

    먼저 키를 만들고 API 키에서 설명한 대로 TRITONIUM_API_KEY 환경 변수에 저장하세요.

    터미널
    openclaw mcp set tritonium '{"url":"https://api.tritonium.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${TRITONIUM_API_KEY}"}}'

    작은따옴표는 저장된 구성에서 ${TRITONIUM_API_KEY}을 리터럴로 유지합니다. OpenClaw는 서버를 로드할 때 환경에서 이를 채웁니다.

    기타 MCP 클라이언트

    MCP 인증을 지원하는 클라이언트는 URL https://api.tritonium.com/mcp만 필요합니다. 서버의 401 응답에서 로그인을 자동으로 찾습니다. 공식 MCP Python SDK의 기본 제공 OAuth 지원은 Tritonium 관련 설정 없이 작동합니다.

    로그인할 수 없는 클라이언트는 사용자 정의 헤더가 있는 원격 Streamable HTTP 서버를 지원하는 경우 API 키를 사용할 수 있습니다. Authorization: Bearer <key> 헤더를 보내세요.

  2. 로그인 및 승인

    에이전트가 처음 연결할 때 브라우저에서 Tritonium을 엽니다. 로그인하고, 어느 앱이 요청하는지 확인하고 어디로 액세스를 보내는지 확인한 후, 에이전트가 볼 수 있고 할 수 있는 작업을 선택한 다음 승인하세요. 그러면 에이전트가 선택한 권한 범위 내에서 작동합니다.

    모든 워크스페이스 멤버가 승인할 수 있습니다

    • 사용자의 앱 apps:read 앱 및 세부 정보를 확인합니다.
    • 리뷰 및 답글 reviews:read 리뷰, 답글 및 답글 초안을 읽습니다.
    • 인사이트 및 분석 analytics:read 인사이트, 평점, 예측 및 활동을 읽습니다.
    • 트리거된 알림 alerts:read 워크스페이스가 받은 알림을 읽습니다.

    관리자와 소유자도 승인할 수 있습니다

    • 답글 초안 reviews:write 팀이 검토할 답글 초안을 작성합니다. 에이전트는 이를 게시할 수 없습니다.
    • 앱 분석과 예측 시작 apps:write AI 앱 분석이나 평점 또는 감정 예측을 시작하거나 아직 대기 중인 분석을 취소합니다.
    • 웹훅 설정 webhooks:manage 웹훅 설정 및 전달 로그를 읽습니다(변경 제외).
  3. 에이전트에게 질문하기

    다음과 같은 프롬프트를 사용해 보세요. 도구는 에이전트가 선택하며, 에이전트가 작성한 회신 초안은 모두 Tritonium에서 승인을 기다립니다.

    • 이번 주에 별 1개 리뷰를 가장 많이 받은 앱은 무엇이고, 사용자들은 무엇에 불만을 갖고 있나요?
    • 내 iOS 앱의 최신 AI 분석을 요약하고 주요 기능 요청을 정리해 주세요.
    • 지난주 평점이 떨어졌습니다. 평점 기록과 최근 리뷰를 비교하고 무엇이 변경되었는지 알려주세요.
    • 가장 최근의 부정적인 리뷰 5개에 대한 회신 초안을 작성해 주세요. Tritonium에서 승인하겠습니다.

API 키

대신 API 키 사용

API 키는 이 페이지의 모든 클라이언트에서 작동합니다. 클라이언트가 로그인할 수 없을 때, 스크립트와 CI 또는 Tritonium CLI에서 사용하세요.

API 키 만들기

워크스페이스 관리자 또는 소유자가 Tritonium 대시보드의 설정 → API 키에서 키를 만듭니다. 에이전트에 필요한 범위만 키에 부여한 다음, 클라이언트가 실행되는 환경에 환경 변수로 설정하세요:

터미널
export TRITONIUM_API_KEY="trtn_live_…"

그런 다음 클라이언트의 위 설정에서 대신 API 키 사용를 열어보세요.

스크립트와 CI에서는 Tritonium CLI가 같은 도구를 호출하고 JSON을 출력합니다. CLI 가이드를 참조하세요.

참조

도구

서버에는 21개의 도구가 있습니다. 에이전트는 권한이 허용하는 도구만 볼 수 있으며, :write 범위는 동일한 도메인에서 읽기 액세스도 부여합니다.

각 도구에 필요한 범위를 표시한 Tritonium MCP 도구 목록
도구 기능 범위
get_workspace_context 워크스페이스, 부여된 범위 및 에이전트가 사용할 수 있는 도구입니다. 항상 사용 가능
list_apps 리뷰 수, 동기화 및 분석 상태, 새 리뷰가 계속 들어오는지 여부를 포함한 앱 목록입니다. apps:read
get_app 앱 하나의 세부 정보, 현재 동기화 및 분석 상태, 새 리뷰가 계속 들어오는지 여부입니다. apps:read
search_reviews 텍스트, 평점, 감정(라벨이 없으면 별점을 따름), 언어 및 날짜로 한 앱의 리뷰를 필터링합니다. reviews:read
get_review 리뷰 하나의 전체 내용과 번역, 개발자 답변(있는 경우)입니다. reviews:read
list_reply_drafts 승인을 기다리는 AI 회신 초안입니다. reviews:read
get_reply_draft ID로 회신 초안의 현재 상태, 본문과 리뷰 식별자를 확인합니다. reviews:read
generate_reply_draft 사람의 승인을 받을 AI 회신 초안을 작성합니다. 게시되지 않습니다. 쓰기 reviews:write
start_app_analysis 앱의 리뷰에 대한 새로운 AI 분석을 대기열에 넣습니다. 드라이 런을 지원합니다. 쓰기 apps:read (dry_run) / apps:write (start)
get_analysis_run 하나의 AI 분석 실행: 상태, 단계, 진행률 및 오류 정보입니다. apps:read
list_analysis_runs 앱의 AI 분석 실행 목록(최신순)으로, 리뷰 동기화 후 시작된 실행도 포함합니다. apps:read
cancel_analysis_run 아직 실행 대기 중인 AI 분석 실행을 취소합니다. 이미 처리 중인 실행은 계속됩니다. 쓰기 apps:write
get_app_insights 최신 AI 분석: 요약, 주요 문제 및 강점, 기능 요청, 버그 및 주제입니다. analytics:read
get_rating_history 일일 또는 주간 별점 추세입니다. analytics:read
get_cached_rating_forecast 새 생성을 시작하지 않고 캐시된 AI 평점 예측을 조회합니다. analytics:read
get_rating_forecast 향후 7~90일의 AI 평점 예측입니다. 쓰기 첫 번째 요청이 예측 생성을 시작할 수 있습니다. analytics:read + apps:write
list_feature_requests 리뷰에서 추출한 기능 요청입니다. analytics:read
list_alerts 워크스페이스에 대해 발생한 경고입니다. alerts:read
list_webhooks 웹훅 엔드포인트와 전송 수입니다. 시크릿은 반환되지 않습니다. webhooks:manage
list_webhook_deliveries 웹훅 하나의 최근 전송 시도입니다. webhooks:manage
list_activity 워크스페이스 활동 피드입니다. analytics:read

서버의 다른 항목

  • 리소스 tritonium://guides/agents: Tritonium을 사용하는 에이전트를 위한 가이드입니다.
  • 프롬프트 triage_negative_reviews 및 investigate_rating_change: 부정적인 리뷰를 분류하고 평점 변화를 조사하기 위한 시작점입니다.

권한

결정은 팀이 내립니다

에이전트는 부여한 권한 범위 내에서 작동하며, 고객에게 도달하는 결정은 팀과 함께 유지됩니다.

범위가 지정되고 취소 가능한 액세스

로그인한 에이전트 또는 API 키는 항상 부여된 권한 안에서 워크스페이스 멤버로 작동합니다. 관리자와 소유자는 설정 → API 키 → 연결된 에이전트에서 에이전트를 연결 해제하고 설정 → API 키에서 키를 취소하거나 교체할 수 있습니다. 멤버는 설정 → 보안 → 연결된 에이전트에서 자신의 에이전트를 연결 해제할 수 있습니다.

자동으로 게시되는 것은 없습니다

대시보드에서 답변 초안을 검토하고 승인하세요. 스토어 게시는 지원되는 연결과 스토어 인증 정보가 필요합니다. 답변을 스토어 콘솔에 복사하여 수동으로 게시할 수도 있습니다.

표시되는 사용량

API 키 탭에는 각 키가 마지막으로 사용된 시간과 요청 수가 표시됩니다. 연결된 에이전트는 각 에이전트를 연결한 사람과 마지막으로 사용된 시간을 보여줍니다.

에이전트가 할 수 없는 작업

이러한 작업은 Tritonium 대시보드에서 로그인한 관리자와 소유자와 함께 유지됩니다. API 키나 승인하는 권한이 에이전트가 이를 수행하도록 허용하지 않습니다.

  • 앱 스토어에서 회신 게시, 승인 또는 거부
  • 앱 연결, 삭제 또는 재동기화
  • 경고 확인 또는 경고 규칙 편집
  • 웹훅 생성 또는 테스트
  • 내보내기, 청구, 팀 및 자격 증명 설정

제한

알아두면 좋은 사항

  • Tritonium CLI는 API 키 또는 제공된 OAuth 액세스 토큰을 받습니다. 로그인하거나 토큰을 갱신하지 않습니다.
  • 대시보드 세션 토큰은 허용되지 않습니다. 에이전트에 로그인하거나 API 키를 사용하세요.
  • 각 API 키와 로그인한 각 에이전트에는 REST API와 공유되는 자체 한도가 있습니다. 분당 600개 요청, 10분마다 60개의 새 AI 초안, 분석 또는 예측입니다. 요청은 IP 주소별로도 제한됩니다. 도구가 RATE_LIMITED를 반환하면 다시 시도하기 전에 retry_after_seconds를 확인하세요.
  • AI 분석과 회신 초안은 플랜의 AI 사용량을 사용합니다. 추정에는 글이 있는 리뷰를 사용하며 스토어의 모든 별점은 포함하지 않습니다. 향후 스토어에 표시될 평점에 대한 정확도는 검증되지 않았습니다. 모델 범위는 보정된 신뢰 구간이 아닙니다.
  • 브라우저 기반 클라이언트는 Tritonium 자체 오리진에서만 연결할 수 있습니다.
  • xAI의 호스팅된 에이전트인 Grok Bot은 Tritonium으로 테스트되지 않았습니다.

구조화된 오류

오류는 안정적인 error.code, retryable 플래그 및 retry_after_seconds가 있는 도구 결과로 반환되므로 에이전트는 재시도 여부 및 시기를 알 수 있습니다.

오류 코드

  • INVALID_ARGUMENT
  • AUTHENTICATION_FAILED
  • PERMISSION_DENIED
  • SUBSCRIPTION_INACTIVE
  • NOT_FOUND
  • CONFLICT
  • RATE_LIMITED
  • UPSTREAM_UNAVAILABLE
  • UPSTREAM_TIMEOUT
  • INTERNAL_ERROR

테스트한 클라이언트

이 페이지의 클라이언트 설정은 에 Claude Code 2.1.277, Codex CLI 0.155.0, Cursor CLI 2026.09.15, GitHub Copilot CLI 1.0.86, Grok CLI 1.0.34, Antigravity CLI 1.2.6, OpenClaw 2026.9.4 및 MCP Python SDK 2.2.0로 테스트했습니다. 각각 프로덕션 서버에 로그인했습니다.

앱 리뷰를 에이전트에서 활용하세요

Tritonium에서 App Store 및 Google Play 앱을 연결한 후 서버를 에이전트에 추가하고 로그인하세요.