통합 카탈로그

통합 카탈로그는 Revka가 지원하는 모든 채팅 채널, 모델 제공업체, 생산성 커넥터, 플랫폼을 정적으로 나열한 목록입니다. 80개의 항목이 9개의 카테고리로 분류되어 있습니다. 각 항목에는 현재 설정을 기반으로 실시간 계산된 상태가 표시되므로, 카탈로그는 연결된 항목, 활성화할 수 있는 항목, 그리고 아직 로드맵에 있는 항목을 한눈에 파악할 수 있는 지도 역할도 합니다.

어떤 통합이 존재하는지, 대시보드 상태 배지가 어떻게 결정되는지, 그리고 REST API나 CLI에서 동일한 데이터를 프로그래밍 방식으로 읽는 방법을 알고 싶을 때 이 페이지를 참고하세요.

참고

카탈로그는 정보 제공 용도입니다. 통합의 상태를 보여줄 뿐, 직접 설정을 변경하지는 않습니다. Available 상태의 통합을 Active로 전환하려면 설정을 편집해야 합니다. 설정 개요와 아래 링크된 각 영역별 가이드를 참고하세요.

카탈로그가 포함하는 항목

카탈로그는 Revka 바이너리에 정적으로 정의되어 있으므로, 어떤 채널이나 제공업체를 설정했는지와 관계없이 항상 존재합니다. 모든 항목에는 네 가지 필드가 있습니다.

필드	의미
name	표시 이름. 예: Telegram, OpenRouter, Home Assistant.
description	한 줄 요약. 예: Bot API — long-polling.
category	9개의 카테고리 중 하나(아래 참조).
status	현재 설정에서 실시간 계산된 값: Active, Available, ComingSoon.

상태 값

세 가지 상태 값이 대시보드 배지와 CLI/API 출력을 결정합니다.

상태	배지	의미
Active	Active	완전히 구현되었고 현재 설정에서 설정/활성화된 상태 — 바로 사용할 수 있습니다.
Available	Available	완전히 구현되었지만 아직 설정되지 않은 상태. 관련 설정을 추가하면 활성화됩니다.
ComingSoon	Coming Soon	계획되었지만 아직 구현되지 않은 상태. 출시 전까지는 설정을 추가해도 효과가 없습니다.

가장 중요한 차이점: **Available은 “구현은 완료, 켜기만 하면 됨”**을 의미하고, **ComingSoon은 “아직 개발되지 않음”**을 의미합니다. ComingSoon 항목은 설정에 무엇을 추가하더라도 Active가 되지 않습니다.

상태 계산 방식

상태는 저장되지 않으며, 카탈로그를 읽을 때마다 현재 config.toml을 기반으로 재계산됩니다. 계산 방식은 통합 유형에 따라 다릅니다.

• 채널은 해당 설정 섹션이 존재할 때 Active가 됩니다. 예: [channels_config.telegram], [channels_config.discord], [channels_config.matrix], [channels_config.email]. 그 외에는 Available.
• 모델 제공업체는 기본값으로 선택되었을 때 Active가 됩니다. 대부분은 default_provider를 확인합니다(예: openrouter, ollama, groq). 일부는 default_model 접두사로 판단합니다(Google → google/, DeepSeek → deepseek/, xAI → x-ai/, Mistral → mistral). 그 외에는 Available.
• 기능 토글은 해당 서브시스템이 활성화되었을 때 Active가 됩니다: Browser ([browser] enabled = true), Cron ([cron] enabled = true), Google Workspace ([google_workspace] enabled = true).
• 플랫폼 (macOS, Linux)은 바이너리가 해당 OS에서 실행 중일 때 Active이며, Windows, iOS, Android는 항상 Available입니다.

지역 제공업체 별칭

지역별 제공업체 이름은 동일한 카탈로그 항목으로 연결됩니다. default_provider를 minimax-cn, glm-cn, moonshot-intl, qwen-intl, zai-cn, baidu로 설정하면 각각 MiniMax, GLM, Moonshot, Qwen, Z.AI, Qianfan 항목이 활성화됩니다.

항상 활성 상태인 통합

다음 세 가지 통합은 설정 없이도 항상 Active 상태입니다. 선택적으로 연결하는 커넥터가 아닌 에이전트의 핵심 기능이기 때문입니다.

통합	카테고리	항상 활성인 이유
Shell	Tools & Automation	터미널 명령 실행이 기본으로 내장되어 있습니다.
File System	Tools & Automation	파일 읽기/쓰기 접근이 기본으로 내장되어 있습니다.
Weather	Tools & Automation	wttr.in에서 실시간 날씨를 가져옵니다. API 키가 필요하지 않습니다.

또한, 현재 실행 중인 플랫폼(macOS 또는 Linux)도 자동으로 Active로 표시됩니다.

주의

Shell과 File System이 항상 활성 상태라고 해서 Revka의 보호 정책을 우회한다는 의미는 아닙니다. 명령 실행과 파일 쓰기는 여전히 보안 정책, 샌드박싱, 승인 흐름을 거칩니다. 정책, 명령 및 샌드박싱을 참고하세요.

카테고리

카탈로그는 모든 항목을 9개의 카테고리로 분류합니다. API에서는 카테고리가 변형 이름(왼쪽 열)으로 직렬화되며, 대시보드에는 사람이 읽기 쉬운 레이블(오른쪽 열)로 표시됩니다.

카테고리 (API 값)	레이블	예시
Chat	Chat Providers	Telegram, Discord, Slack, WhatsApp, Matrix, Signal, iMessage, Email
AiModel	AI Models	OpenRouter, Anthropic, OpenAI, Google, Ollama, Groq, Bedrock
Productivity	Productivity	Google Workspace, GitHub, Notion, Linear, Trello, Obsidian
MusicAudio	Music & Audio	Spotify, Sonos, Shazam
SmartHome	Smart Home	Home Assistant, Philips Hue, 8Sleep
ToolsAutomation	Tools & Automation	Shell, File System, Weather, Browser, Cron, Canvas
MediaCreative	Media & Creative	Image Gen, GIF Search, Screen Capture, Camera
Social	Social	Twitter/X, Email
Platform	Platforms	macOS, Linux, Windows, iOS, Android

Chat Providers

설정이 완료되면 Active가 되는 구현된 채널: Telegram, Discord, Slack, Webhooks, WhatsApp, Signal, iMessage, Matrix, DingTalk, QQ Official. 예정됨(ComingSoon): Microsoft Teams, Nostr, WebChat, Nextcloud Talk, Zalo.

각 채널의 설정 방법은 채널 개요를 참고하세요.

AI Models

가장 많은 항목을 보유한 카테고리로, 29개의 모델 제공업체가 포함되어 있습니다. 기본값으로 선택하면 Active가 되는 구현된 제공업체: OpenRouter, Anthropic, OpenAI, Google, DeepSeek, xAI, Mistral, Ollama, Perplexity, Venice, Vercel AI, Cloudflare AI, Moonshot, Synthetic, OpenCode Zen, OpenCode Go, Z.AI, GLM, MiniMax, Qwen, Amazon Bedrock, Qianfan, Groq, Together AI, Fireworks AI, Novita AI, Cohere. 예정됨(ComingSoon): Hugging Face, LM Studio.

제공업체 선택 및 설정 방법은 제공업체 카탈로그를 참고하세요.

Productivity

Google Workspace는 구현되어 있으며, [google_workspace] enabled = true 설정 시 Active가 됩니다. 나머지는 ComingSoon입니다: GitHub, Notion, Apple Notes, Apple Reminders, Obsidian, Things 3, Bear Notes, Trello, Linear.

참고

카탈로그의 Notion 커넥터는 ComingSoon으로 표시됩니다. 다른 문서에 설명된 Notion, Jira, Composio, Microsoft 365, LinkedIn MCP 도구는 Revka의 MCP 서버를 통해 제공되는 별도의 자격 증명 기반 도구 인터페이스로, 카탈로그 항목과는 다릅니다. MCP 서버로서의 Revka와 생산성 통합 도구를 참고하세요.

Tools & Automation

항상 활성 상태인 핵심 도구와 설정 기반 서브시스템이 혼합되어 있습니다. 항상 Active: Shell, File System, Weather. 설정 필요: Browser ([browser] enabled), Cron ([cron] enabled). 예정됨(ComingSoon): Voice, Gmail, 1Password, Canvas.

Music & Audio, Smart Home, Media & Creative, Social, Platforms

• Music & Audio: Spotify, Sonos, Shazam — 모두 ComingSoon.
• Smart Home: Home Assistant, Philips Hue, 8Sleep — 모두 ComingSoon.
• Media & Creative: Image Gen, GIF Search, Screen Capture, Camera — 모두 ComingSoon.
• Social: Twitter/X (ComingSoon); Email ([channels_config.email] 설정 시 Active).
• Platforms: macOS / Linux (해당 OS에서 Active), Windows / iOS / Android (Available).

REST API로 카탈로그 읽기

카탈로그를 노출하는 두 개의 Bearer 인증 엔드포인트가 있습니다. 두 엔드포인트 모두 페어링된 토큰이 필요합니다(페어링 및 인증 참고).

모든 통합과 상태 목록 조회

GET /api/integrations
Authorization: Bearer <token>

curl -s http://127.0.0.1:8080/api/integrations \
  -H "Authorization: Bearer $REVKA_TOKEN"

응답 — 항목 배열로, category와 status는 열거형 변형 이름으로 직렬화됩니다.

{
  "integrations": [
    {
      "name": "Telegram",
      "description": "Bot API — long-polling",
      "category": "Chat",
      "status": "Active"
    },
    {
      "name": "Shell",
      "description": "Terminal command execution",
      "category": "ToolsAutomation",
      "status": "Active"
    },
    {
      "name": "Notion",
      "description": "Workspace & databases",
      "category": "Productivity",
      "status": "ComingSoon"
    }
  ]
}

플랫 설정 맵

설정 엔드포인트는 이름을 키로 하여 동일한 데이터를 반환하며, 파생된 enabled 불리언 값을 포함합니다. **enabled는 status가 Active일 때만 true**입니다. Available과 ComingSoon은 모두 false로 매핑됩니다.

GET /api/integrations/settings
Authorization: Bearer <token>

{
  "settings": {
    "Telegram": { "enabled": true,  "category": "Chat",            "status": "Active" },
    "Discord":  { "enabled": false, "category": "Chat",            "status": "Available" },
    "Spotify":  { "enabled": false, "category": "MusicAudio",      "status": "ComingSoon" },
    "Shell":    { "enabled": true,  "category": "ToolsAutomation", "status": "Active" }
  }
}

두 엔드포인트 모두 읽기 전용이며, 요청 시점의 현재 설정을 반영합니다. 쓰기 경로는 없습니다. 통합의 상태를 변경하려면 아래 설명과 같이 설정을 편집해야 합니다.

CLI로 카탈로그 읽기

CLI는 단일 통합을 조회하는 서브커맨드 하나를 제공합니다.

revka integrations info <name>

이름을 대소문자 구분 없이 조회하여 아이콘과 함께 상태(✅ Active, ⚪ Available, 🔜 Coming Soon), 카테고리, 그리고 일부 통합에 대한 간단한 설정 힌트를 출력합니다. 예를 들면 다음과 같습니다.

revka integrations info telegram

  ⚪ Telegram — Bot API — long-polling
  Category: Chat Providers
  Status:   Available

  Setup:
    1. Message @BotFather on Telegram
    2. Create a bot and copy the token
    3. Run: revka onboard --channels-only
    4. Start: revka channel start

알 수 없는 이름을 입력하면 revka onboard를 안내하는 오류가 반환됩니다. 내장된 설정 힌트는 Telegram, Discord, Slack, OpenRouter, Ollama, iMessage, GitHub, Browser, Cron, Weather, Webhooks에 대해 제공됩니다. ComingSoon 항목에는 “예정됨” 안내가 출력됩니다.

대시보드에서 카탈로그 보기

대시보드의 Integrations 페이지(/integrations)는 GET /api/integrations 결과를 위에서 설명한 상태 배지가 있는 필터링 가능한 카드 형태로 렌더링합니다. 읽기 전용이며, 카드를 클릭하면 세부 정보를 볼 수 있지만 실제 설정은 Config 페이지에서 이루어집니다. 스킬, 도구 및 통합 페이지를 참고하세요.

통합 활성화하기

항목을 Available에서 Active로 전환하는 방법은 항상 동일합니다: 관련 설정을 추가한 후 재시작하거나 리로드하세요. 설정이 위치하는 곳은 통합 유형에 따라 다릅니다.

메시징 채널 연결 Telegram, Discord, Slack, WhatsApp 등.

제공업체 빠른 시작 모델 제공업체 선택 및 설정.

브라우저 자동화 Browser 통합 활성화.

Cron 개요 크론 작업 활성화 및 스케줄 설정.

설정: 채널, 도구 및 통합 각 항목에 대한 설정 키 안내.

온보딩 마법사 revka onboard를 통한 안내 설정.

관련 페이지

MCP 서버로서의 Revka 자격 증명 기반 생산성 도구 인터페이스 (Notion, Jira, Composio, M365, LinkedIn).

생산성 통합 도구 통합 도구에 대한 도구 수준 레퍼런스.

상태, 설정 및 도구 엔드포인트 게이트웨이 상태 및 설정 API 전체 안내.

revka channel & integrations 채널 및 통합에 대한 CLI 레퍼런스.