02.1 — Integration· 5 min read

The Klyph MCP server.

Klyph ships a hosted Model Context Protocol server so AI agents — Claude, Cursor, Zed — can create projects, ingest videos, and list generated clips as tools. No npm install, no self-hosting.

§ 1

What is MCP, briefly

The Model Context Protocol is an open standard for exposing tools, resources, and prompts to LLMs. An MCP server publishes capabilities; any MCP-aware client can connect and call them.

§ 2

Connect

The server is hosted at https://app.klyph.ai/api/mcp. Point any MCP-aware client at that URL with a bearer token generated from workspace settings.

Tip
No install. No process to babysit.
Klyph hosts the MCP server for you. Just configure the URL and your token — the client takes care of the rest.
claude_desktop_config.json
{
  "mcpServers": {
    "klyph": {
      "url": "https://app.klyph.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer klp_xxx"
      }
    }
  }
}
cursor — .cursor/mcp.json
{
  "mcpServers": {
    "klyph": {
      "url": "https://app.klyph.ai/api/mcp",
      "headers": { "Authorization": "Bearer klp_xxx" }
    }
  }
}
§ 3

Tools

The server exposes the capabilities that are live in Klyph today — backed by the same workspace data you see in the dashboard.

FieldTypeDescription
create_projecttoolCreate a new project in a workspace
upload_videotoolUpload a long-form source to a project
process_videotoolSubmit an uploaded video for clip generation — returns a call id
get_process_resulttoolPoll the status/result of a processing call
list_clipstoolReturn generated clips for a video with preview URLs
get_video_summarytoolCounts of ready, draft, and failed clips for a video
§ 4

Example: end-to-end from Claude

chat-transcript.txt
You › Create a project "Fall Interviews", upload the Loom at
        this URL, and kick off clip generation with default
        settings.

Claude › I'll use klyph.create_project, klyph.upload_video,
         then klyph.process_video.

         [create_project] → project_id=proj_abc
         [upload_video] → video_id=vid_123
         [process_video] → call_id=call_789

         Processing is running. Want me to poll until it's
         done and list the generated clips?
§ 5

Auth & scope

Every tool call runs as the workspace the API key belongs to. Tokens can be rotated at any time from the dashboard and scoped so they only read or only write.

Careful
Don't paste production keys into shared agents.
Use a dedicated key per environment, and prefer read-only scopes when letting an agent drive exploratory work.