Klavis Strata

공식

AI 에이전트가 모든 도구를 안정적으로 어떤 규모에서든 사용할 수 있는 하나의 MCP 서버

Klavis Strata MCP(으)로 무엇을 할 수 있나요?

  • 관련 작업 찾기 — 자연어 의도를 사용해 이름이 지정된 서버 전반에서 카테고리나 작업을 찾도록 어시스턴트에게 요청합니다. discover_server_categories_or_actions를 사용합니다.
  • 카테고리 작업 목록 조회 — 세부 정보를 확인하기 전에 get_category_actions로 특정 카테고리에 속한 모든 작업 이름을 가져옵니다.
  • 작업 스키마 확인 — 카테고리와 작업 이름을 지정해 get_action_details로 특정 작업의 필수 및 선택 매개변수를 확인합니다.
  • 작업 실행 — execute_action을 통해 경로, 쿼리, 본문 매개변수로 작업을 실행하고, 선택적으로 include_output_fields로 반환 필드를 제한합니다.
  • 서버 문서 검색 — 검색으로 충분한 정보를 얻지 못한 경우 search_documentation을 사용해 서버 문서에서 키워드로 엔드포인트를 찾습니다.
  • 인증 오류 해결 — 인증 오류가 발생하면 handle_auth_failure를 사용해 인증 안내를 받거나 자격 증명을 저장합니다.

문서

Strata

AI 에이전트가 어떤 규모에서든 도구를 점진적으로 사용할 수 있도록 지원하는 단일 MCP 서버

Strata Hero - Progressive tool discovery for AI agents

Strata란?

Strata는 AI 에이전트가 어떤 복잡성에서도 도구를 안정적으로 사용하도록 안내하는 단일 MCP 서버입니다. 모든 것을 한꺼번에 제공해 에이전트를 압도하는 대신, 사람이 도구와 상호작용하는 방식을 고려해 설계되었으며 오늘날 AI 에이전트를 괴롭히는 세 가지 주요 문제를 해결합니다.

  • 도구 과부하: 도구가 너무 많으면 LLM이 선택에 어려움을 겪습니다
  • 컨텍스트 과부하: 긴 도구 목록은 토큰 수와 비용을 급증시킵니다
  • 지원 범위의 한계: 대부분의 서버는 도구가 40~50개에 머물러 구축할 수 있는 범위가 제한됩니다

웹사이트, API를 통해 Strata를 사용하거나, 자체 데이터에서 오픈 소스로 사용할 수도 있습니다!

동영상 튜토리얼

Strata의 작동 방식을 완전히 이해하려면 이 동영상 튜토리얼을 시청하세요.

Strata

텍스트 튜토리얼

[!TIP]

Strata가 실제로 작동하는 모습을 보려면 이 공유된 Claude 대화를 확인하세요!

1. 서버 카테고리 또는 작업 검색

discover_server_categories_or_actions - 사용자 의도에 따라 관련 카테고리 또는 작업을 찾습니다. 시맨틱 검색은 사용하지 않습니다!

[accordion] 도구 세부 정보

설명: 권장 시작 지점. 사용자 쿼리를 바탕으로 사용 가능한 카테고리 또는 작업을 검색합니다. 서버 전반에서 사용 가능한 작업을 살펴볼 때는 먼저 이 도구를 사용해 보세요. 사용 가능한 작업을 탐색하는 기본 진입점이며, 다른 검색 방법보다 먼저 사용해야 합니다. 출력은 세부 정보 수준과 세부 정보를 포함한 서버 목록입니다.

세부 정보 수준이 'categories_only'이면 세부 정보에는 카테고리 이름만 포함됩니다. 다음 단계에서는 get_category_actions 도구를 사용해 해당 카테고리의 작업을 가져오는 것이 좋습니다.

세부 정보 수준이 'full_details'이면 세부 정보에는 작업 세부 정보가 포함된 카테고리 이름 목록이 포함됩니다. 이는 서버에 작업이 몇 개 없을 때 발생합니다. 다음 단계에서는 execute_action 도구를 사용해 작업을 실행하는 것이 좋습니다.

세부 정보 수준이 'categories_and_actions'이면 세부 정보에는 카테고리 이름과 작업 이름이 포함됩니다. 이는 외부 도구를 사용할 때 발생합니다. 다음 단계에서는 get_action_details 도구를 사용해 작업 세부 정보를 가져오는 것이 좋습니다.

매개변수:

  • user_query (string, required): 결과를 필터링할 자연어 사용자 쿼리입니다.
  • server_names (array, required): 카테고리 또는 작업을 검색할 서버 이름 목록입니다.

2. 카테고리 작업 가져오기

get_category_actions - 지정된 카테고리에 속한 모든 작업 이름을 가져옵니다.

[accordion] 도구 세부 정보

설명: 특정 카테고리에서 사용할 수 있는 API 작업을 종합적으로 살펴봅니다. 특정 서비스 카테고리에서 사용할 수 있는 작업을 탐색하거나 카테고리의 기능을 자세히 확인하려면 이 도구를 사용하세요. ** 중요 **: discover_server_categories 도구에서 서버 카테고리를 가져온 후에만 호출해야 합니다.

매개변수:

  • category_names (array, required): 작업을 가져올 카테고리 목록입니다.

3. 작업 세부 정보 가져오기

get_action_details - 특정 작업의 전체 스키마와 매개변수를 가져옵니다.

[accordion] 도구 세부 정보

설명: 필수 및 선택적 매개변수를 포함해 특정 작업에 대한 자세한 정보를 가져옵니다. 카테고리 이름과 작업 이름을 제공해야 합니다. ** 중요 **: 이전 도구 호출에서 서버 카테고리를 가져온 후에만 호출해야 합니다.

매개변수:

  • category_name (string, required): 카테고리 이름입니다.
  • action_name (string, required): 카테고리 내 작업/연산 이름입니다.

4. 작업 실행

execute_action - 매개변수를 사용해 작업을 실행하고 결과를 가져옵니다.

[accordion] 도구 세부 정보

설명: 제공된 매개변수로 특정 작업을 실행합니다. 서버 이름, 작업 이름, 작업 매개변수를 제공해야 합니다. ** 중요 **: get_action_details 도구에서 작업 세부 정보를 가져온 후에만 호출해야 합니다.

매개변수:

  • server_name (string, required): 서버 이름입니다.
  • category_name (string, required): 작업을 실행할 카테고리 이름입니다.
  • action_name (string, required): 실행할 작업/연산 이름입니다.
  • path_params (string, optional): 작업의 경로 매개변수를 포함하는 JSON 문자열입니다.
  • query_params (string, optional): 작업의 쿼리 매개변수를 포함하는 JSON 문자열입니다.
  • body_schema (string, optional, default: "{}"): 작업의 요청 본문을 포함하는 JSON 문자열입니다.
  • include_output_fields (array, optional): 선택 사항이지만, 이전 도구 호출에서 이 작업의 response_schema를 알고 있다면 강력히 권장됩니다. 응답에 포함할 필드 경로의 배열입니다. 지정된 필드만 반환됩니다. 중첩 필드에는 점 표기법을 사용하세요(예: "author.displayName").
  • maximum_output_characters (integer, optional): 선택 사항: 응답에서 반환할 최대 문자 수입니다. 응답이 이 제한을 초과하면 잘립니다. 이 옵션보다 include_output_fields를 사용하는 것이 좋습니다.

5. 문서 검색

search_documentation - 필요한 경우에만 관련 정보를 찾습니다.

[accordion] 도구 세부 정보

설명: 보조 옵션: discover_server_categories에서 충분한 세부 정보를 제공하지 않거나 특정 서버의 문서 내에서 검색해야 할 때만 이 도구를 사용하세요. 키워드 일치를 사용해 카테고리, 연산, 태그 또는 기능별로 서버 작업 문서를 검색합니다. 자연어 검색이 아니며 정확한 키워드와 구문을 일치시킵니다. 관련성 순으로 정렬된 엔드포인트를 반환합니다. 가장 적합한 결과를 찾으려면 몇 가지 구체적인 키워드를 사용하세요. 일반적인 패턴: 카테고리 이름('projects', 'users', 'pipelines'), 작업('create', 'delete', 'list', 'get') 또는 조합('create user', 'list projects'). 검색 알고리즘은 설명 필드가 지나치게 길어 결과를 압도하지 않도록 스마트 점수 산정 방식을 사용합니다.

매개변수:

  • query (string, required): API 문서 용어와 일치하는 검색 키워드입니다. 권장 사항: (1) 'users', 'projects', 'files'와 같은 리소스 이름을 사용합니다. (2) 'user create' 또는 'project delete'처럼 작업을 추가해 정확도를 높입니다. (3) 'how to', 'show me', 'all the'와 같은 불필요한 단어는 피하고 엔드포인트 이름과 설명에 등장하는 핵심 용어에 집중합니다.
  • server_name (string, required): 검색할 서버 이름입니다.
  • max_results (integer, optional, default: 10, minimum: 1, maximum: 50): 반환할 결과 수입니다. 기본값: 10

6. 인증 실패 처리

handle_auth_failure - 필요한 경우에만 인증을 처리합니다.

[accordion] 도구 세부 정보

설명: 작업 실행 중 발생한 인증 실패를 처리합니다. 중요: 이 도구는 execute_action이 인증 문제(401 Unauthorized, 잘못된 자격 증명, 만료된 토큰 등)로 인해 실패한 경우에만 호출해야 합니다. 인증 상태를 확인하거나 다른 목적으로는 호출하지 마세요. 사용 방법: (1) execute_action에서 인증 오류가 반환되면 이 도구를 'get_auth_url'과 함께 호출해 인증 안내를 가져옵니다. (2) 실패 후 사용자가 인증 데이터를 제공하면 이 도구를 'save_auth_data'와 함께 호출해 자격 증명을 저장합니다. 실패 원인이 인증 문제가 아닌 경우(예: 404 Not Found, 500 Internal Server Error 등)에는 절대 이 도구를 호출하지 마세요.

매개변수:

  • server_name (string, required): execute_action 중 인증에 실패한 서버 이름입니다.
  • intention (string, required, enum: ["get_auth_url", "save_auth_data"]): execute_action이 인증 오류로 실패했을 때 인증 안내를 가져오려면 'get_auth_url'을 사용합니다. 인증 실패 후 사용자가 인증 자격 증명을 제공하면 'save_auth_data'를 사용합니다.
  • auth_data (object, optional): 인증 실패 후 사용자가 제공한 인증 데이터입니다(예: {"token": "...", "api_key": "..."}). 인증 실패를 해결할 때 'save_auth_data' 의도와 함께 사용하는 경우에만 적용됩니다.

평가

Strata는 실질적인 성과를 제공합니다.

  • MCPMark 벤치마크: 공식 GitHub 서버보다 pass@1 비율이 15.2% 더 높고, 공식 Notion 서버보다 pass@1 비율이 13.4% 더 높습니다. (출처)
  • 사람 평가: 2천 건이 넘는 실제 쿼리 평가 세트에서 83% 이상의 정확도를 기록합니다.

다음 단계

[card] 시작하기

몇 분 만에 첫 Strata 서버를 만드세요.

[card] API 참조

Strata API 전체를 살펴보세요.

이 문서는 개발자 문서 플랫폼인 Mintlify에서 빌드하고 호스팅합니다.