Set up EaseKit in Claude
Add EaseKit's MCP server to Claude Desktop with one click, or to Claude Code with one command.
EaseKit includes an MCP server, easekit-mcp. It lets Claude and other MCP clients work on the same sessions as the app: what Claude makes shows up in EaseKit within a moment, with its quality score. The server runs locally as a child process of your client and speaks MCP over stdio.
Open Settings → Claude & MCP. It shows whether the server is installed and whether Claude Desktop knows about it, and has copy buttons for everything below.
Status
| Status line | Meaning | What to do |
|---|---|---|
| Added to Claude Desktop | Claude Desktop's config points at this EaseKit | Restart Claude Desktop if the tools don't show up |
| Not added to Claude Desktop yet | No EaseKit entry | Use step 1 below |
| Claude Desktop isn't set up for MCP yet | Claude Desktop has no MCP config file | Use step 1 below; EaseKit creates it |
| Claude Desktop uses another copy of EaseKit | The entry points at a different EaseKit.app | Click Add to Claude Desktop again |
Claude Desktop
- Open Settings → Claude & MCP in EaseKit.
- Click Add to Claude Desktop. EaseKit adds itself to Claude Desktop's config and keeps your other servers; the old file is backed up next to it. Show Config in Finder opens it.
- Restart Claude Desktop. MCP servers load when it starts.
The entry EaseKit adds looks like this:
{ "mcpServers": { "easekit": { "command": "/Applications/EaseKit.app/Contents/MacOS/easekit-mcp", "args": [] } } }Claude Code
Run this once in Terminal:
claude mcp add easekit -- "/Applications/EaseKit.app/Contents/MacOS/easekit-mcp"Add --scope user to use EaseKit in every project.
Other MCP clients
Most clients (Cursor, Zed, VS Code and others) accept the JSON above in their MCP settings.
Starter prompts
The server also offers three ready-made prompts that walk the model through EaseKit's workflow. In clients that show MCP prompts, pick them from the prompt menu:
| Prompt | Arguments | What it asks for |
|---|---|---|
| Design an animation in EaseKit | description (required), context (uiMicro, uiTransition, productTeaser or socialClip) | Read the motion guide, create the animation, fix blockers, open it in the app, and summarize the key decisions with values |
| Refine an EaseKit animation | feedback (required), session_id (default: latest) | Read the animation, translate the feedback into one targeted edit, and report each change before → after |
| Export an EaseKit animation | format (required), path, session_id | Check quality, mention blockers, export and explain how to use the file |
Troubleshooting
| If this happens | Try this |
|---|---|
| The tools don't show up | Restart the client after adding EaseKit; MCP servers load at launch. |
| The path is wrong | It must point at easekit-mcp inside the EaseKit.app you use. After moving the app, add it again. |
| Claude Desktop uses another copy of EaseKit | Click Add to Claude Desktop again. |
| A tool says a session wasn't found | Ask Claude to call list_sessions first, or use latest. |