Inkling

Desktop setup · About 5 minutes

Your website, from your desktop app.

Connect ChatGPT or Codex to this Inkling website. Find content, prepare changes, and work with your own website account.

You need your desktop app, a website login, and permission to make the changes you want. The connection uses your app account for the conversation and your Inkling account for website access.

Step 1

Connect this website

Copy the complete address, including /mcp.

Codex in the desktop app

  1. Open Settings → MCP servers → Add server.
  2. Name it after your website. Choose Streamable HTTP and paste the server URL above.
  3. Save, then select Restart. If sign-in is needed, select Authenticate.
  4. The browser opens this website's Inkling sign-in page. Sign in with your own website account and review the access requested.
  5. Return to the app. Type /mcp in the composer and check that this server is connected.

ChatGPT chats

ChatGPT chats use a personal plugin. Adding a server to Codex does not automatically create that plugin.

  1. Open ChatGPT Settings → Security and login and enable Developer mode.
  2. Open Plugins, select the plus button, and enter the server URL above. Choose OAuth when asked for authentication.
  3. Finish the connection and sign in to this Inkling website when prompted.
  4. Open your personal plugin and install it. Start a new Work chat, type @, and select your website plugin.

Menus and access depend on your app version and workspace. If these options are missing, use the current official setup links below or ask your workspace administrator. The website password belongs on the Inkling sign-in page, never in a chat message.

Step 2

Make a read-only connection check

Start with this message:

Use the Inkling connection to tell me which website and account I am connected to, what I am allowed to change, and which pages are available. Do not change anything.

The app should call get_connection and list_types, then list your pages. Check the website address and account before asking for edits.

Try a real workflow

Prepare a homepage campaign for [book title]. Find the book and its current cover, check which hero controls my site supports, and show me the exact changes. Do not save yet.

Once the proposal is correct, ask it to apply those changes. Updating an already published page changes the live website immediately. A new page starts as a draft; ask to publish only when it is ready. Check the public page after saving.

Step 3 · Optional

Add reusable workflows

The connection works without skills. These small instruction files teach the app repeatable workflows around Inkling's tools.

inklingedit

Edit or draft Inkling website content through a connected Inkling MCP server, including copy, shared contact details, and navigation. Use for requested website updates, not source-code development.

Download skill

inklingcampaign

Prepare an Inkling homepage for a book release or seasonal campaign using existing catalog entries, covers, hero artwork, and website colors. Use when promoting releases on a connected publishing website.

Download skill

inklingsitereview

Review a connected Inkling website before a demo or publication for missing content, hero artwork, navigation, and publishing status. Use for a read-only content readiness check.

Download skill

Install in Codex

Download the files, then ask Codex to install each as a local skill. It should place each file in a folder matching its name, as ~/.codex/skills/inklingedit/SKILL.md, for example. Start a new conversation after installation. You can invoke a skill with $inklingedit, $inklingcampaign, or $inklingsitereview.

Use with ChatGPT

Ask the built-in skill creator to make a reusable workflow using the downloaded instructions and your Inkling plugin. Availability depends on your workspace. If you cannot install skills, use the example prompts above with the connected plugin.

The MCP server also exposes these files for plugin builders. Importing them into a distributed plugin is a separate packaging step; connecting the website alone does not install skills.

If something does not work

The server is listed but no tools are available

Select Restart, authenticate if prompted, and start a new conversation. In Codex, check /mcp. In ChatGPT, install the personal plugin and select it with @ in Work.

Sign-in fails or the connection has expired

Authenticate again using your Inkling website login. Each person needs their own account. If the browser reports an invalid callback, send your site manager the error text and app name, without passwords or tokens.

I can read pages but cannot change them

The connection respects your website role. Ask your site administrator whether your account has editing or publishing permission. Reconnecting does not grant a higher role.

An edit timed out

Ask the app to read the entry again before retrying. The save may already have completed. Review the current values and revision history.

I want to disconnect

Remove the server or plugin in your app. In Inkling, open Agent keys and revoke the connection key if you have access; otherwise ask the site administrator to revoke it. App removal alone may not revoke the server credential immediately.