Inkspring.

Inkspring Help

Set up your writing agent, add provider keys, or get your publishing connections working on your Mac.

Write with your agent

Use your signed-in Codex or Claude Code session to write and revise. You don’t need a separate provider API key for this.

  1. Install and sign in to Codex or Claude Code on the Mac where you run Inkspring.
  2. In Inkspring, open Settings → AI agents. Enable Let AI agents use Inkspring and click Test connection to check the local MCP server.
  3. Open Settings → AI models, choose Connected agent (MCP) under Writing connection, pick your writing agent, then click Test writing connection.

If it doesn’t work: If the local server test passes but the writing test fails, open your selected agent on the same Mac and confirm that it’s signed in and can answer a prompt. Then retry the writing test. If you want to call Inkspring from the agent itself, use the client setup shown under AI agents: save the project connection for Claude Code or add an STDIO MCP server in Codex with the Command and Argument shown.

Add an API key

You only need a key for the provider you choose. OpenAI and Gemini can generate image files. Anthropic, OpenAI, and Gemini can also handle writing if you select Provider API key under Settings → AI models.

OpenAIGeminiAnthropicApifyX Bearer Token

OpenAI

Image generation and optional API writing.

  1. Open OpenAI key settings. Choose your API project, then select Create new secret key and copy it.
  2. In Inkspring, go to Settings → API keys → OpenAI, paste the value into the key field, and click Save key. The row confirms it was saved in Keychain.
  3. For writing, select that provider in AI models and click Test writing connection.
  4. For images, choose OpenAI under AI models → Image provider.

If it doesn’t work: Check that the key belongs to the project with API billing and access to the selected model. ChatGPT billing is separate.

Gemini

Nano Banana image generation and optional API writing.

  1. Open Gemini key settings. Select Create API key in Google AI Studio. Choose a project and copy the new key.
  2. In Inkspring, go to Settings → API keys → Gemini, paste the value into the key field, and click Save key. The row confirms it was saved in Keychain.
  3. For writing, select that provider in AI models and click Test writing connection.
  4. For images, choose Nano Banana under AI models → Image provider.

If it doesn’t work: Check the project’s billing, quota, and access to the selected model. If your key is old, create a new one in AI Studio.

Anthropic

Optional API writing with Claude.

  1. Open Anthropic key settings. Select the workspace you want to use, create an API key, and copy it.
  2. In Inkspring, go to Settings → API keys → Anthropic, paste the value into the key field, and click Save key. The row confirms it was saved in Keychain.
  3. For writing, select that provider in AI models and click Test writing connection.

If it doesn’t work: Check API credits in the Anthropic Console. If you entered a workspace ID in Inkspring, it should match the key’s workspace.

Apify

Public research and post lookups.

  1. Open Apify key settings. Under API tokens, create or select a token and copy it.
  2. In Inkspring, go to Settings → API keys → Apify, paste the value into the key field, and click Save key. The row confirms it was saved in Keychain.

If it doesn’t work: Check that your token can run the research task and that your Apify account has usage available.

X Bearer Token

Reading public X posts. Publishing requires a separate X sign-in.

  1. Open the X developer console. Open your X developer app, find Keys and tokens, then generate or copy the Bearer Token.
  2. In Inkspring, go to Settings → API keys → X Bearer Token, paste the value into the key field, and click Save key. The row confirms it was saved in Keychain.

If it doesn’t work: Confirm your X developer access includes the read endpoints you need. If the token was regenerated, save the new value in Inkspring.

Connect a social account

  1. Open Connections in the Inkspring sidebar. Find your platform and click Connect… if available.
  2. In your browser, check the account name, approve the requested access, and return to Inkspring.
  3. Click Test connection and confirm that Inkspring shows the right account. This check doesn’t publish a post.

If shared sign-in is unavailable, open Use your own developer app on the platform’s card and follow its setup below.

LinkedInXInstagramRedditTikTok

LinkedIn

  1. Open LinkedIn developer settings. Open or create your app. In Products, request Share on LinkedIn and Sign In with LinkedIn using OpenID Connect. In Auth, add the redirect URL below and copy the Client ID and Client secret.https://inkspring.ai/desktop-connect/
  2. In Connections → LinkedIn, expand the developer app setup, enter the requested credentials, then click Save developer app.
  3. Click Connect developer app…, approve access in the browser, then return to Inkspring. Click Test connection on the account card.

If it doesn’t work: Check that the redirect matches exactly, including the port or trailing slash. Leave Request company Page access off for a personal profile. Company Page access requires Community Management approval and a suitable Page role.

X

  1. Open X developer settings. Open your X developer app and enable OAuth 2.0 user authentication. Choose Native App and Read and write permissions, add the callback URL below, and copy the OAuth 2.0 Client ID.http://127.0.0.1:43821/oauth/x
  2. In Connections → X, expand the developer app setup, enter the requested credentials, then click Save developer app.
  3. Click Connect developer app…, approve access in the browser, then return to Inkspring. Click Test connection on the account card.

If it doesn’t work: Check that the redirect matches exactly, including the port or trailing slash. Use the OAuth Client ID here. The Bearer Token in API keys is for reading posts. If you changed app permissions, reconnect to authorize them.

Instagram

  1. Open Instagram developer settings. Set up the Instagram API with Instagram Login for a professional account. Add the redirect URL below in the Instagram login settings, then copy the Instagram App ID and Instagram App Secret.https://inkspring.ai/desktop-connect/
  2. In Connections → Instagram, expand the developer app setup, enter the requested credentials, then click Save developer app.
  3. Click Connect developer app…, approve access in the browser, then return to Inkspring. Click Test connection on the account card.

If it doesn’t work: Check that the redirect matches exactly, including the port or trailing slash. If the Meta app is in development mode, make sure your Instagram account is authorized to test it. For attached images, also check media hosting.

Reddit

  1. Open Reddit developer settings. If your Reddit developer access permits app registration, register an installed app with the redirect URL below. Copy the Client ID shown beneath the app name.http://127.0.0.1:43821/oauth/reddit
  2. In Connections → Reddit, expand the developer app setup, enter the requested credentials, then click Save developer app.
  3. Click Connect developer app…, approve access in the browser, then return to Inkspring. Click Test connection on the account card.

If it doesn’t work: Check that the redirect matches exactly, including the port or trailing slash. If you cannot create or authorize an app, check your Reddit developer access. The installed-app setup in Inkspring only asks for the Client ID.

TikTok

  1. Open TikTok developer settings. In your TikTok developer app, set up Login Kit for Desktop and add the redirect URL below. Request Content Posting API access for Direct Post, then copy the Client key and Client secret.http://127.0.0.1:43821/oauth/tiktok
  2. In Connections → TikTok, expand the developer app setup, enter the requested credentials, then click Save developer app.
  3. Click Connect developer app…, approve access in the browser, then return to Inkspring. Click Test connection on the account card.

If it doesn’t work: Check that the redirect matches exactly, including the port or trailing slash. Check app review status and publishing permissions. For photo posts with your own app, use a public image URL on a domain verified for that app.

Connect Substack

  1. In Inkspring, open Connections → Substack and click Sign in….
  2. Sign in to Substack in the window Inkspring opens. Once signed in there, click Check connection.
  3. Select the publication under Publication before saving a newsletter to Substack.

If it doesn’t work: If your publication is missing, click Sign in again… and use the account that can edit that publication. If Substack emails you a sign-in link, finish signing in inside the window Inkspring opened.

Set up Instagram media hosting

  1. In Cloudflare R2, create a private bucket. Note your account ID, bucket name, and jurisdiction.
  2. Under Manage R2 API Tokens, create an R2 token with Object Read & Write for just that bucket. Copy the S3 Access Key ID and Secret Access Key.
  3. In Inkspring, open Settings → Storage & backups → Instagram media hosting. Fill in the account, bucket, jurisdiction, and keys. Click Save R2 connection, then Test connection.

If it doesn’t work: Confirm the bucket name and jurisdiction match Cloudflare and that you pasted the S3 credentials. The bucket can stay private.

More from Protomota

Protomota is Brad Dunlap’s independent studio for apps, creative tools, and experiments.

Explore the studio