API 키 및 AI CLI

워크스페이스 데이터를 1MarketingTool 클라우드로 보내지 않고 호스팅 제공업체, 로컬 AI CLI, MCP 통합을 연결하세요.

1MarketingTool은 BYOK 방식입니다. 연결할 제공업체를 사용자가 결정하며, 앱은 사용자 고유의 API 키 또는 로컬 AI CLI를 사용합니다.

지원되는 AI CLI

앱은 일반적인 로컬 AI 명령줄 도구와 함께 작동할 수 있습니다:

CLI일반적인 용도
Claude Code CLI작성 및 분석 작업
Codex CLI코딩, 콘텐츠, 이미지 지원 워크플로
Gemini CLI콘텐츠 및 이미지 지원 워크플로
OpenCode CLI일반 로컬 에이전트 워크플로
Kiro CLI사용 가능한 경우 로컬 에이전트 워크플로
HermesmacOS, Windows, Linux에서 자체 감지; 콘텐츠 생성, Prompt Explorer 비교, 기타 로컬 AI 작업에 원샷 모드로 실행되며 실행마다 모델 선택 가능

실제로 사용하는 CLI만 활성화하세요. CLI가 설치되지 않은 경우 사용자의 기기에서 사용 가능해질 때까지 비활성 상태로 두세요.

호스팅 제공업체

워크플로에 외부 데이터나 선호하는 모델이 필요한 경우 호스팅 제공업체를 사용하세요:

  • 생성을 위한 OpenAI, Claude, Gemini 또는 기타 AI 제공업체.
  • 키워드, SERP, 백링크, 순위 데이터를 위한 DataForSEO.
  • 사이트 성과를 위한 Google Search Console 및 분석 서비스.
  • 예약 게시를 위한 소셜 채널 API.

내 컴퓨터에서 실행되는 모델

BYOK 경로를 호스팅 서비스 대신 이 컴퓨터나 로컬 네트워크에서 실행 중인 모델로 지정할 수 있습니다. LM Studio, Ollama, 1LocalAITool처럼 OpenAI 형식으로 응답하는 서버와, 1LocalAITool도 지원하는 Anthropic 형식으로 응답하는 서버 모두에서 작동합니다.

  1. Settings → AI를 열고 BYOK로 전환합니다.
  2. Gateways에서 Custom OpenAI-compatible을 선택하거나, 서버가 Anthropic 형식을 쓴다면 Protocols에서 Anthropic을 선택합니다.
  3. Base URL에 로컬 서버가 표시하는 주소(예: LM Studio는 http://localhost:1234/v1, Ollama는 http://localhost:11434/v1)를 입력하고, Model에 서버가 제공하는 모델 id를 입력합니다.
  4. API key에 아무 값이나 입력합니다. 이 칸은 비워 둘 수 없지만, 키를 확인하지 않는 로컬 서버는 어떤 값이든 받아들입니다.
  5. Test connection을 클릭한 다음 Use as active를 클릭합니다.

CPU나 작은 GPU에서 실행되는 모델은 느리게 작성하므로, 1MarketingTool은 로컬 Base URL에 응답 시간을 최대 10분까지 줍니다. 호스팅 제공업체는 45초입니다. 이 더 긴 제한은 localhost, 127.x, 10.x, 192.168.x, 172.16–31.x, .local, Tailscale (100.64–127.x, .ts.net) 호스트에 적용됩니다. Custom OpenAI-compatible은 1.5.0부터, Anthropic은 1.5.1부터 적용되므로 느린 로컬 모델로 만든 긴 캠페인이나 글도 중간에 타임아웃되지 않고 끝까지 완성됩니다.

키 저장

API 키와 토큰은 앱 설정을 통해 저장해야 합니다. 게시 토큰은 지원되는 경우 운영 체제 키체인에 저장됩니다. 캠페인 프롬프트나 콘텐츠 필드에 비밀 정보를 붙여넣지 마세요.

MCP 통합

1MarketingTool은 rank, keyword, content, video, browser 도구를 **onemarketingtool**이라는 하나의 로컬 MCP 서버로 공개합니다. 호환되는 AI 클라이언트가 이 기기에서 앱 고유의 워크플로에 닿게 하고 싶을 때 쓰세요 — MCP 통합을 보세요.

문제 해결

제공업체 연결에 실패하면 로그 또는 관련 설정 화면에서 정확한 오류를 확인하세요. 대부분의 실패는 누락된 API 권한, 만료된 토큰, 또는 시스템 경로에 없는 CLI로 인해 발생합니다.