logoKlox

Klox를 AI 에이전트에 연결하기

Claude Code, Codex 등 AI 에이전트에 메시지 하나만 보내면 에이전트가 직접 Klox를 연결하고 캔버스를 만들고 편집할 수 있게 됩니다.

Klox 연결해 줘: https://klox.ai/agent
  1. 1

    이 메시지를 에이전트에 보내세요

    Claude Code, Codex 등 터미널 명령을 실행할 수 있는 에이전트에 붙여 넣으세요.

  2. 2

    에이전트가 Klox를 추가하도록 하세요

    Agent가 이 페이지를 읽고 Klox에 연결한 뒤 창작 Skills를 설치합니다. 요청하면 명령을 승인해 주세요.

  3. 3

    브라우저에서 접근 허용

    Klox 페이지가 열립니다. 로그인하고 권한을 확인한 뒤 허용을 누르세요. 에이전트에 아직 Klox가 보이지 않으면 세션을 다시 시작하세요.

연결된 앱 관리

창작 Skills와 함께 Klox 연결하기

MCP는 Agent에 Klox 도구를 제공합니다. 창작 Skills는 기획, 에셋 일관성, 샷 검토, 사운드 확인, 편집을 안내합니다. 연결할 때 canvas, asset-design, drama를 함께 설치하세요. 플러그인에는 세 가지가 모두 포함되어 있습니다.

Skill 파일 보기

다른 에이전트: MCP + Skill

1. MCP 도구 연결

Streamable HTTP를 통한 원격 MCP와 OAuth 인증을 지원하는 클라이언트를 사용하세요. MCP 설정에서 klox라는 서버를 추가하고 아래 URL을 입력한 다음 Streamable HTTP를 선택하세요.

https://klox.ai/mcp

연결 또는 인증을 선택한 후 브라우저에서 Klox에 로그인하고 접근을 허용하세요. 크레딧을 사용한 생성 권한은 선택 사항입니다.

2. Klox Skill 추가

https://klox.ai/agent/skills.md

이 페이지에는 Klox의 각 Skill과 파일이 나와 있습니다. Skill마다 하나의 폴더로, 표시된 경로를 유지해 클라이언트의 스킬 디렉터리에 저장하세요. 스킬을 지원하지 않으면 새 세션마다 canvas의 SKILL.md(에피소드형 드라마라면 drama의 SKILL.md도)를 읽도록 에이전트에게 요청하세요. Skill은 Klox 사용법을 설명하며 MCP 연결이나 인증을 수행하지 않습니다.

에이전트에게 list_workflows를 호출하여 연결을 확인하도록 요청하세요. 인증 후에도 도구가 표시되지 않으면 연결을 새로고침하거나 세션을 다시 시작하세요.

AI 에이전트용 안내

# Connect Klox to this agent

Klox (https://klox.ai) is a visual canvas for AI video creation. The user sent you this page because they want you to connect to their Klox account, so you can read and edit their canvases and, if they allow it, start generations with their credits.

Do the setup yourself; the user should only need to approve commands and sign in once in the browser. Never ask the user for a password, API key or token: authorization happens in their browser through OAuth.

MCP supplies the canvas tools. The skills supply the creative workflow: story and shot planning, reusable visual references, generation review, sound checks and editing. A working MCP connection alone does not mean the skills are installed.

You install two things: the Klox MCP server (https://klox.ai/mcp, remote, Streamable HTTP, OAuth), which gives you the tools, and the Klox skills: canvas (https://klox.ai/agent/skills/canvas/SKILL.md), the working method for planning a film with the user, laying out the canvas, writing prompts and spending credits carefully; asset-design (https://klox.ai/agent/skills/asset-design/SKILL.md), the method for designing reusable characters, locations and props; and drama (https://klox.ai/agent/skills/drama/SKILL.md), the production method for episodic dramas.

## 1. Add Klox

- Claude Code — install the plugin, which brings the MCP server and the skills:
  `claude plugin marketplace add SeektonAI/klox-agent`
  `claude plugin install klox@klox`
  If the plugin commands are not available, use instead:
  `claude mcp add --scope user --transport http klox https://klox.ai/mcp`
  Install the skills using the skill installation instructions below.
- Codex — install the plugin, which brings the MCP server and the skills:
  `codex plugin marketplace add SeektonAI/klox-agent`
  `codex plugin add klox@klox`
  `codex mcp login klox`
  If the plugin commands are not available, use instead:
  `codex mcp add klox --url https://klox.ai/mcp`
  Install the skills using the skill installation instructions below.
  `codex mcp login klox`
- Cursor — install the Klox plugin from Customize if it is listed. The plugin brings the MCP server and the skills. If it is not listed, have the user open this link so Cursor installs the MCP server, then download the skills:
  `cursor://anysphere.cursor-deeplink/mcp/install?name=klox&config=eyJ1cmwiOiJodHRwczovL2tsb3guYWkvbWNwIn0%3D`
  Install the skills using the skill installation instructions below.
  Ask the user to enable the server named `klox` in Customize and choose Connect. Start a new Agent chat so the skills load.
- Grok — install the plugin, which brings the MCP server and the skills:
  `grok plugin marketplace add SeektonAI/klox-agent`
  `grok plugin install klox --trust`
  If the plugin commands are not available, use instead:
  `grok mcp add --transport http klox https://klox.ai/mcp`
  Install the skills using the skill installation instructions below.
  A plugin installed in this session is not loaded yet. Reload plugins or start a new Grok session first. In that session, the first Klox tool call opens OAuth in the browser; tell the user to sign in and click Allow, then continue there.
- DeepSeek Harness — install the Klox bundle, which brings the MCP server and the skills. Run `dsh plugin --profile web add "git+https://github.com/SeektonAI/klox-agent.git#main&path:/plugins/klox"` (replace `web` with the profile the user runs), or ask the user to open Plugins, turn on the experimental custom plugin market, add the index source `https://raw.githubusercontent.com/SeektonAI/klox-agent/main/dsh-market/index.json` under Discover and install Klox. The bundle connects through `npx mcp-remote`, so Node.js must be installed. Ask the user to restart DSH so the bundle loads; on start a browser window opens for OAuth.
- Any other client — follow the generic MCP + Skill setup below.

### Other agents: generic MCP + Skill setup

1. Check that the client supports remote MCP servers over Streamable HTTP and OAuth sign-in. In its MCP settings, add a server named `klox` with URL `https://klox.ai/mcp` and transport `Streamable HTTP`. Use the client's own configuration format; there is no single configuration file or command shared by all clients. If you cannot edit its settings, give the user these values to enter.
2. Use the client's Connect or Authenticate action to start OAuth, then let the user sign in and approve access in their browser as described in step 2 below. A client without remote MCP and OAuth support cannot use this setup directly.
3. Install the Klox skills listed at https://klox.ai/agent/skills.md. If the client supports SKILL.md skills, save each skill's files under that client's documented skills directory with the paths shown there, and reload skills as required. Otherwise, read the canvas SKILL.md (plus asset-design SKILL.md when designing reusable assets, and drama SKILL.md for episodic dramas) into the current conversation and follow it; read it again in a new session. The skills explain how to work with Klox, but do not install or authorize the MCP connection.
4. Once the tools are available, call `list_workflows` to verify the connection. If the tools are missing after authorization, reload the connection or restart the session according to the client's instructions.

Plugins connect to the production server at https://klox.ai/mcp. For a different Klox deployment, use the manual MCP and skill commands with the URLs above.

### Install the creative skills

Complete this as part of connecting Klox, before reporting setup as finished. The plugin includes the skills; a direct MCP connection needs the manual skill installation below.

1. Check whether the Klox plugin already supplies canvas, asset-design and drama. If so, use its skills; do not install duplicate manual copies. For a manual installation, check the existing skill folders and preserve user customizations before updating files.
2. For a client that supports local SKILL.md skills, download all files of all three skills, including references, using the matching client directory:

- Claude Code:
  `mkdir -p ~/.claude/skills/klox-canvas ~/.claude/skills/klox-canvas/references && for f in SKILL.md references/previs.md references/prompt-writing.md references/video-models.md; do curl -fsSL https://klox.ai/agent/skills/canvas/$f -o ~/.claude/skills/klox-canvas/$f; done`
  `mkdir -p ~/.claude/skills/klox-asset-design ~/.claude/skills/klox-asset-design/references && for f in SKILL.md references/characters.md references/locations.md references/props.md references/review-and-handoff.md; do curl -fsSL https://klox.ai/agent/skills/asset-design/$f -o ~/.claude/skills/klox-asset-design/$f; done`
  `mkdir -p ~/.claude/skills/klox-drama ~/.claude/skills/klox-drama/references && for f in SKILL.md references/clips.md references/develop.md references/edit.md references/script.md references/storyboard.md; do curl -fsSL https://klox.ai/agent/skills/drama/$f -o ~/.claude/skills/klox-drama/$f; done`
- Codex:
  `mkdir -p ~/.agents/skills/klox-canvas ~/.agents/skills/klox-canvas/references && for f in SKILL.md references/previs.md references/prompt-writing.md references/video-models.md; do curl -fsSL https://klox.ai/agent/skills/canvas/$f -o ~/.agents/skills/klox-canvas/$f; done`
  `mkdir -p ~/.agents/skills/klox-asset-design ~/.agents/skills/klox-asset-design/references && for f in SKILL.md references/characters.md references/locations.md references/props.md references/review-and-handoff.md; do curl -fsSL https://klox.ai/agent/skills/asset-design/$f -o ~/.agents/skills/klox-asset-design/$f; done`
  `mkdir -p ~/.agents/skills/klox-drama ~/.agents/skills/klox-drama/references && for f in SKILL.md references/clips.md references/develop.md references/edit.md references/script.md references/storyboard.md; do curl -fsSL https://klox.ai/agent/skills/drama/$f -o ~/.agents/skills/klox-drama/$f; done`
- Cursor:
  `mkdir -p ~/.cursor/skills/klox-canvas ~/.cursor/skills/klox-canvas/references && for f in SKILL.md references/previs.md references/prompt-writing.md references/video-models.md; do curl -fsSL https://klox.ai/agent/skills/canvas/$f -o ~/.cursor/skills/klox-canvas/$f; done`
  `mkdir -p ~/.cursor/skills/klox-asset-design ~/.cursor/skills/klox-asset-design/references && for f in SKILL.md references/characters.md references/locations.md references/props.md references/review-and-handoff.md; do curl -fsSL https://klox.ai/agent/skills/asset-design/$f -o ~/.cursor/skills/klox-asset-design/$f; done`
  `mkdir -p ~/.cursor/skills/klox-drama ~/.cursor/skills/klox-drama/references && for f in SKILL.md references/clips.md references/develop.md references/edit.md references/script.md references/storyboard.md; do curl -fsSL https://klox.ai/agent/skills/drama/$f -o ~/.cursor/skills/klox-drama/$f; done`
- Grok:
  `mkdir -p ~/.grok/skills/klox-canvas ~/.grok/skills/klox-canvas/references && for f in SKILL.md references/previs.md references/prompt-writing.md references/video-models.md; do curl -fsSL https://klox.ai/agent/skills/canvas/$f -o ~/.grok/skills/klox-canvas/$f; done`
  `mkdir -p ~/.grok/skills/klox-asset-design ~/.grok/skills/klox-asset-design/references && for f in SKILL.md references/characters.md references/locations.md references/props.md references/review-and-handoff.md; do curl -fsSL https://klox.ai/agent/skills/asset-design/$f -o ~/.grok/skills/klox-asset-design/$f; done`
  `mkdir -p ~/.grok/skills/klox-drama ~/.grok/skills/klox-drama/references && for f in SKILL.md references/clips.md references/develop.md references/edit.md references/script.md references/storyboard.md; do curl -fsSL https://klox.ai/agent/skills/drama/$f -o ~/.grok/skills/klox-drama/$f; done`
- Other clients: use the file list at https://klox.ai/agent/skills.md and the client's documented skill directory. Do not guess a directory or claim persistent installation when the client cannot save skills. If local installation is unavailable, read canvas from https://klox.ai/agent/skills/canvas/SKILL.md, asset-design from https://klox.ai/agent/skills/asset-design/SKILL.md when designing assets, and drama from https://klox.ai/agent/skills/drama/SKILL.md for episodic work; follow their linked references as needed. Repeat that reading in each new session.

3. Verify that each installed skill has its SKILL.md and every reference listed at https://klox.ai/agent/skills.md; do not report success after a partial download. Read the relevant installed entrypoints for the current task. Reload skills or start a new session only as the client requires for future discovery. Tell the user which skills were installed or already available, or that you are using them only in this session. Installing skills does not authorize generation or spending credits.

## 2. Let the user approve access

Claude Code: a newly installed plugin is not loaded yet, so first ask the user to run `/reload-plugins` (or restart Claude Code; after a manual `claude mcp add`, restart), then run `/mcp`, select `klox` and choose Authenticate. Codex: if you have not already run `codex mcp login klox` in step 1, run it now (the server is named `klox` for both plugin and manual installations), then complete OAuth in the browser. If login reports that the server was not found, use `codex mcp list` to find the actual Klox server name and retry login with that name. After authorizing, ask the user to start a new Codex session: the plugin's tools and skill load only in a new session, so continue there. Cursor: ask the user to open Customize, enable the `klox` server, and choose Connect, then complete OAuth in the browser. If the tools or skills do not appear, start a new Agent chat and continue there. Grok: reload plugins or start a new session first, so the plugin is loaded. In that session, call a Klox tool; the first call opens the browser. Tell the user to sign in and click Allow, then continue there. DeepSeek Harness: after the restart, the browser opens by itself; tell the user to sign in and click Allow, then start a new session and continue there.

A Klox page opens in the browser. Tell the user to sign in (or create an account), check the permissions and click Allow. "Generate with your credits" is optional; without it you can still read and edit canvases.

If the Klox tools or the skills do not show up, ask the user to restart this session and continue there.

## 3. Check the connection

Call `list_workflows`. If it answers and the Klox skills are installed or the relevant skills have been read into this session, tell the user setup is complete and ask what they want to make. State when skills are available only in this session rather than installed persistently.