How to Use CodivUpload's MCP Server with Claude or ChatGPT

Step-by-step

1. 1

   Install the CodivUpload MCP server

   It's a single npx command — no global install, no registry config, nothing to clone. The server is published as the codivupload-mcp npm package and runs as a local stdio process the MCP client launches on demand.

   npx codivupload-mcp --help

2. 2

   Add it to Claude Desktop's config

   Open Claude Desktop's config file at Settings → Developer → Edit Config. The file is claude_desktop_config.json under your home directory. Add a new entry under mcpServers. The CODIVUPLOAD_API_KEY env var is how the MCP server authenticates — set it once here and every Claude conversation has access to your CodivUpload workspace.

   {
     "mcpServers": {
       "codivupload": {
         "command": "npx",
         "args": ["-y", "codivupload-mcp"],
         "env": {
           "CODIVUPLOAD_API_KEY": "YOUR_API_KEY"
         }
       }
     }
   }

3. 3

   Restart Claude Desktop

   Claude picks up new MCP servers on launch — there's no hot reload. After restart, you'll see codivupload tools in the tool list at the top of any conversation, alongside any other MCP servers you have configured. The list updates automatically if CodivUpload ships new endpoints; the MCP server reads the live OpenAPI spec at startup, so you don't need to update the npm package to gain new tools.

4. 4

   Try a prompt

   "Schedule a TikTok video and an Instagram Reel for tomorrow at 10am Eastern. Use my profile 'my_brand', the video at https://cdn.example.com/clip.mp4, and a caption that hints at productivity." Claude reads your prompt, picks the create_post tool, fills in profile_name, platforms, scheduled_date, and description, and shows you the planned tool call before executing. Approve it and the post goes live in CodivUpload's queue.

5. 5

   Use with ChatGPT, Cursor, or any other MCP client

   The same config pattern works in every MCP-compatible client — only the config file path differs. ChatGPT Pro: Settings → Connectors → Add MCP server (paste the same JSON). Cursor: ~/.cursor/mcp.json with the same shape. Zed: settings.json's context_servers field. The CodivUpload MCP server is client-agnostic; it speaks the standard MCP stdio protocol.

Frequently asked