코딩 에이전트에 OceanToken 추가하기

OceanToken은 코딩 에이전트용 MCP 서버와 플러그인을 제공합니다. 이를 쓰면 에이전트가 모델 카탈로그를 검색하고, 요청 비용을 확인하고, 이미지·동영상·내레이션을 생성하고, 오디오를 전사하고, 하위 작업을 다른 모델에 맡길 수 있으며, 모든 비용은 OceanToken 잔액에서 결제됩니다.

추가되는 것은 도구이며, 에이전트는 자기 모델을 그대로 씁니다. 에이전트 자체를 OceanToken 모델로 실행하려면 에이전트를 OceanToken에서 실행하기를 보세요.

플러그인, 명령줄 설치 프로그램, 매니페스트는 github.com/OceanTokenAI/oceantoken-plugins에 오픈 소스로 공개되어 있습니다.

Claude Code: 플러그인 설치

Claude Code에 이 두 명령을 입력합니다:

/plugin marketplace add OceanTokenAI/oceantoken-plugins
/plugin install oceantoken@oceantoken

그런 다음 /mcp를 실행하고 plugin:oceantoken:oceantoken을 고른 뒤 Authenticate를 선택해 로그인합니다. 플러그인은 아래 도구와 스킬을 추가합니다. 다른 에이전트는 명령 하나로 연결하기를 보세요.

에이전트가 얻는 것

도구	하는 일
search_models	이름, 유형, 제공사, 기능, 가격으로 카탈로그 검색
get_model	가격, 제한, 모델이 받는 크기·길이·입력
estimate_cost	실행 전 요청 비용과 잔액으로 충분한지 여부
generate_image	텍스트로 이미지 생성 및 이미지 편집, 미리보기와 다운로드 링크 포함
create_video와 get_job	텍스트, 첫(과 마지막) 프레임, 참고 자료로 동영상 생성
generate_speech	내레이션과 낭독
transcribe_audio	전사와 SRT 또는 VTT 자막
ask_model	하위 작업을 다른 모델에 맡기기: 더 저렴한 모델이나 두 번째 의견
upload_file	로컬 파일을 참고 자료로 사용
get_account	잔액, 사용 가능 잔액, 지출

세 가지 스킬이 에이전트에게 도구를 잘 쓰는 법을 알려 줍니다. oceantoken-media는 프로젝트용 이미지·동영상·오디오를 만들고, oceantoken-models는 모델을 고르고 가격을 매기고 작업을 위임하며, oceantoken-setup은 Codex나 Claude Code 자체를 OceanToken에서 실행하거나 앱을 OceanToken에 연결합니다.

명령 하나로 연결하기

에이전트에게 이렇게 요청하세요:

Install OceanToken for me by following https://mcp.oceantoken.ai/install

또는 터미널에서 직접 실행합니다:

npx -y @oceantoken/cli@latest connect <client>

Node.js 18.17 이상이 필요합니다. <client>는 다음 중 하나입니다:

클라이언트	<client>	로그인
Codex(CLI 또는 앱)	codex	명령이 브라우저를 열고 기다림
Claude Code(터미널, IDE 확장, 데스크톱 앱)	claude-code	명령이 브라우저를 열고 기다림
Cursor	cursor	Cursor의 Settings → Tools & MCP에서
Gemini CLI	gemini	Gemini CLI에서 /mcp auth oceantoken
OpenClaw	openclaw	명령이 브라우저를 열고 기다림
OpenCode	opencode	명령이 브라우저를 열고 기다림
VS Code(GitHub Copilot)	vscode	VS Code에서 서버가 시작될 때
WorkBuddy	workbuddy	WorkBuddy에서
Hermes Agent	hermes	명령이 브라우저를 열고 기다림
Windsurf / Devin Desktop	windsurf	Cascade에서

모든 클라이언트에 MCP 서버와 세 가지 스킬이 설치됩니다. 단, Windsurf는 스킬 폴더가 없어 서버만 설치됩니다.

명령이 바꾸는 것:

• Codex, Claude Code, Gemini CLI, OpenClaw에는 클라이언트 자체 명령줄로 플러그인을 설치합니다. --api-key를 쓰면 Codex, Claude Code, Gemini CLI에는 대신 설정 파일에 oceantoken 항목 하나를 추가합니다.
• 나머지 클라이언트에는 MCP 설정 파일에 oceantoken 항목 하나를 추가합니다. 기존 항목은 유지하며, 주석이 있는 파일은 절대 다시 쓰지 않고 붙여 넣을 스니펫을 보여 줍니다.
• 설정 파일을 처음 바꾸기 전에 <file>.bak-oceantoken으로 복사하고, 이 사본은 절대 덮어쓰지 않습니다. 연결과 해제를 몇 번 반복해도 원본이 남습니다. 이후 변경할 때마다 직전 상태를 <file>.bak-oceantoken-<UTC time>으로 남깁니다. 백업은 단순 복사본이므로 원본에 키가 있으면 백업에도 있습니다.
• 스킬은 클라이언트 자체 스킬 폴더에 들어갑니다.

다시 실행해도 안전하며, 설치한 것을 업데이트합니다. 마지막에 요약이 출력됩니다. Result가 connected이면 끝이고, incomplete이면 앱에서 로그인하기나 세션 다시 시작하기처럼 남은 작업이 Next 아래에 나옵니다.

옵션

--api-key <key|->   Use an API key instead of OAuth sign-in ("-" reads it from stdin)
--use-env-key       Use the key in OCEANTOKEN_API_KEY
--no-login          Configure only; do not start the sign-in
--no-skills         Do not install the OceanToken skills
--dry-run           Show what would change without changing anything
--json              Print the report as JSON
--url <mcp-url>     MCP endpoint (default https://mcp.oceantoken.ai/mcp)

npx -y @oceantoken/cli@latest clients는 지원 클라이언트와 이 컴퓨터에 설치된 클라이언트를 보여 줍니다.

로그인

로그인은 OAuth입니다. 로그인 페이지에서 두 가지 방법으로 연결할 수 있습니다:

• Sign in: OceanToken 이메일과 비밀번호로 로그인합니다. 연결하는 앱용 API 키가 만들어지며, 콘솔의 API Keys에서 확인하고 취소할 수 있습니다. 신규 사용자는 같은 페이지에서 계정을 만들 수 있습니다.
• API key: 이미 가진 키를 붙여 넣습니다. 에이전트가 쓸 수 있는 금액에 상한을 두려면 그 키에 크레딧 한도를 설정하세요.

키를 취소하면 에이전트 연결이 즉시 끊깁니다.

브라우저 없이 키로 연결할 때는 셸 기록에 남지 않도록 stdin으로 전달하세요. 명령은 키를 다른 프로그램의 명령줄에 넣지 않고 출력하지도 않으며, 클라이언트 설정 파일에만 씁니다(OpenClaw는 stdin으로 받아 자체 설정에 씁니다):

printf %s "$OCEANTOKEN_API_KEY" | npx -y @oceantoken/cli@latest connect <client> --api-key -

직접 설정하기

명령과 같은 결과를 클라이언트별로 직접 설정하는 방법입니다.

Codex

codex plugin marketplace add OceanTokenAI/oceantoken-plugins
codex plugin add oceantoken@oceantoken
codex mcp login oceantoken

마지막 명령이 로그인 페이지를 엽니다. Codex 앱에서는 marketplace를 추가한 다음 Plugins 패널에서 OceanToken을 설치하고, 요청할 때 로그인할 수도 있습니다.

브라우저 없이

서버나 CI 등 브라우저 로그인이 불가능한 곳에서는 플러그인 대신 API 키로 서버를 추가합니다:

export OCEANTOKEN_API_KEY=sk-...
codex mcp add oceantoken --url https://mcp.oceantoken.ai/mcp --bearer-token-env-var OCEANTOKEN_API_KEY

Codex는 변수 이름만 저장하고, 시작할 때마다 그 변수에서 키를 읽습니다. codex mcp list에 이 서버가 Bearer token 인증으로 표시됩니다. 이 방법은 도구만 추가하고 스킬은 추가하지 않습니다. npx -y @oceantoken/cli@latest connect codex --use-env-key는 둘 다 추가하지만, 키 자체를 config.toml에 씁니다.

codex exec의 유료 도구

codex exec는 중간에 물어볼 수 없으므로, 잔액을 쓰거나 파일을 업로드하는 도구를 모두 MCP tool call requires approval, but approval policy is never로 거부합니다. 해당 도구는 generate_image, create_video, generate_speech, transcribe_audio, ask_model, upload_file입니다. 실행에 필요한 도구를 승인하고, 도구가 돌려준 것을 Codex가 내려받을 수 있도록 샌드박스에 네트워크 접근을 허용하세요:

codex exec -s workspace-write \
  -c 'mcp_servers.oceantoken.tools.generate_image.approval_mode="approve"' \
  -c 'mcp_servers.oceantoken.tools.generate_speech.approval_mode="approve"' \
  -c sandbox_workspace_write.network_access=true \
  "Make a hero image for the landing page and save it as hero.png"

• -c 'mcp_servers.oceantoken.default_tools_approval_mode="approve"'는 OceanToken 도구를 한 번에 모두 승인합니다.
• 도구는 다운로드 링크를 돌려줍니다. sandbox_workspace_write.network_access=true가 없으면 Codex 샌드박스에 네트워크가 없어 다운로드가 실패합니다.
• search_models, get_model, estimate_cost, get_account, get_job은 읽기만 하므로 승인 없이 실행됩니다.
• 이 -c 재정의는 서버가 config.toml에 있을 때(위의 codex mcp add나 connect codex --use-env-key로 추가한 경우) 동작합니다. 플러그인을 쓰면 Codex가 invalid transport in mcp_servers.oceantoken으로 멈추므로, codex exec에서는 키 방식을 쓰세요.

Claude Code

/plugin marketplace add OceanTokenAI/oceantoken-plugins
/plugin install oceantoken@oceantoken
/mcp

/mcp에서 plugin:oceantoken:oceantoken을 고르고 Authenticate를 선택합니다.

Claude 데스크톱 앱과 claude.ai

Settings → Connectors → Add custom connector에서 URL에 https://mcp.oceantoken.ai/mcp를 넣고 Connect를 누릅니다. 이렇게 하면 도구가 추가되며, 스킬은 Claude Code 플러그인에 포함되어 있습니다.

Cursor

Cursor에 MCP 서버 추가하기. 도구를 처음 실행할 때 Cursor가 로그인을 요청합니다. 스킬도 받으려면 Cursor marketplace 매니페스트가 있는 저장소에서 플러그인을 설치하거나 위의 명령을 쓰세요.

Gemini CLI

gemini extensions install https://github.com/OceanTokenAI/oceantoken-plugins

그다음 Gemini CLI 안에서 /mcp auth oceantoken을 실행해 로그인합니다. 이 확장에는 MCP 서버와 세 가지 스킬이 들어 있습니다.

OpenClaw

openclaw plugins install clawhub:@oceantoken/oceantoken --accept-capabilities
openclaw mcp set oceantoken '{"url":"https://mcp.oceantoken.ai/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login oceantoken

패키지에는 세 가지 스킬이 들어 있습니다. mcp set은 OpenClaw에 서버를 등록해 mcp login으로 로그인할 수 있게 합니다.

그 밖의 MCP 클라이언트

서버는 https://mcp.oceantoken.ai/mcp이며 streamable HTTP를 씁니다. 동적 클라이언트 등록을 지원하는 OAuth를 제공하므로, 대부분의 클라이언트는 URL만 있으면 됩니다:

{
  "mcpServers": {
    "oceantoken": { "type": "http", "url": "https://mcp.oceantoken.ai/mcp" }
  }
}

API 키를 쓰려면 bearer token으로 보내세요:

# Codex, without the plugin
export OCEANTOKEN_API_KEY=sk-...
codex mcp add oceantoken --url https://mcp.oceantoken.ai/mcp --bearer-token-env-var OCEANTOKEN_API_KEY

# Claude Code, without the plugin
claude mcp add --transport http oceantoken https://mcp.oceantoken.ai/mcp \
  --header "Authorization: Bearer $OCEANTOKEN_API_KEY"

이 서버는 공식 MCP Registry에도 ai.oceantoken/mcp로 등록되어 있어, registry를 탐색하는 클라이언트는 이름으로 찾을 수 있습니다.

에이전트가 쓰게 하기

에이전트는 도구를 스스로 고릅니다. 동영상, 내레이션, 자막, 비용 견적처럼 스스로 못 하는 일에는 OceanToken을 씁니다. 그 밖의 일은 이름을 들어 요청하세요:

• Codex에서는 $oceantoken-media ..., Claude Code에서는 /oceantoken:oceantoken-media ..., 또는 간단히 "OceanToken으로 ……해 줘".

• 또는 AGENTS.md(Codex)나 CLAUDE.md(Claude Code)에 프로젝트 규칙으로 적어 두세요:

  Generate images, video, voice-overs and subtitles with the OceanToken tools.
  Estimate the cost first and ask me before spending more than $2.

비용

도구가 생성한 것은 API와 같은 가격으로 잔액에서 차감됩니다. 모델을 보세요. 먼저 에이전트에게 견적을 요청하세요. estimate_cost가 그 용도입니다. 동영상 작업은 시작할 때 예상 비용을 잡아 두고 끝나면 실제 비용을 청구하며, 실패한 작업은 청구하지 않습니다. 모든 요청은 콘솔의 Logs에 표시됩니다.

제거하기

npx -y @oceantoken/cli@latest disconnect <client>

connect가 추가한 것만 제거합니다. 접근을 즉시 끊으려면 API Keys에서 에이전트의 키를 취소하세요.