# Connect your AI agent to Postnero

Postnero is self-service social publishing software for AI agents. Connect the agent you already use, then let it prepare, schedule, publish, and check TikTok video and photo posts. MP4 uploads and carousel-to-video conversion are included on Free and Pro. See /skill.md for the video workflow. Instagram is limited to approved testers; YouTube is planned.

## Before you connect

1. Create a free account at <https://postnero.com/login?mode=register>.
2. In Settings, connect TikTok and create an API key beginning with `ck_`.
3. Keep the key private. Never commit it to a repository or paste it into a public chat.

Postnero MCP server: `https://postnero.com/mcp`

Authentication header: `Authorization: Bearer ck_your_key_here`

Transport: Streamable HTTP

## Codex

Codex CLI and the Codex IDE extension use the MCP servers configured on your Codex host. Add this to `~/.codex/config.toml`, make your private key available as POSTNERO_API_KEY in the environment of the Codex process, restart the client, then type `/mcp`.

```toml
[mcp_servers.postnero]
url = "https://postnero.com/mcp"
bearer_token_env_var = "POSTNERO_API_KEY"
```

Official guide: <https://developers.openai.com/codex/mcp/>

## Claude Code

Run these commands in Terminal after replacing the example key:

```sh
claude mcp add --scope user --transport http postnero https://postnero.com/mcp --header "Authorization: Bearer ck_your_key_here"
claude mcp list
```

Official guide: <https://code.claude.com/docs/en/mcp>

## Cursor

Add this server to the global file at `~/.cursor/mcp.json`, then restart Cursor:

```json
{
  "mcpServers": {
    "postnero": {
      "url": "https://postnero.com/mcp",
      "headers": {
        "Authorization": "Bearer ck_your_key_here"
      }
    }
  }
}
```

Official guide: <https://cursor.com/docs/mcp>

## Gemini CLI

Run these commands in Terminal after replacing the example key:

```sh
gemini mcp add --scope user --transport http --header "Authorization: Bearer ck_your_key_here" postnero https://postnero.com/mcp
gemini mcp list
```

Official guide: <https://geminicli.com/docs/tools/mcp-server/>

## Windsurf

In Cascade, open MCPs, choose Configure, and merge this into `~/.codeium/windsurf/mcp_config.json`. Replace the example key, save, then refresh the MCP list.

```json
{
  "mcpServers": {
    "postnero": {
      "serverUrl": "https://postnero.com/mcp",
      "headers": {
        "Authorization": "Bearer ck_your_key_here"
      }
    }
  }
}
```

Official guide: <https://docs.windsurf.com/windsurf/cascade/mcp>

## VS Code Chat

Run `MCP: Open User Configuration` from the Command Palette. Add this configuration to use Postnero from the local Chat view. VS Code asks for the key once and stores it securely.

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "postnero-key",
      "description": "Postnero API key",
      "password": true
    }
  ],
  "servers": {
    "postnero": {
      "type": "http",
      "url": "https://postnero.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:postnero-key}"
      }
    }
  }
}
```

Official guide: <https://code.visualstudio.com/docs/agents/reference/mcp-configuration>

## GitHub Copilot coding agent

In your GitHub repository, open Settings, then Copilot, then MCP servers. Add an Agents secret named `COPILOT_MCP_POSTNERO_KEY` with your Postnero key as its value, then save this configuration:

```json
{
  "mcpServers": {
    "postnero": {
      "type": "http",
      "url": "https://postnero.com/mcp",
      "headers": {
        "Authorization": "Bearer ${COPILOT_MCP_POSTNERO_KEY}"
      },
      "tools": ["*"]
    }
  }
}
```

Only enable this connection for a repository you trust because the coding agent can use allowed MCP tools autonomously.

Official guide: <https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers>

## Other agents

Any agent that supports a remote Streamable HTTP MCP server with bearer authentication can connect to the same endpoint. Agents that make normal web requests can use the [Postnero REST API](https://postnero.com/docs/api).

Postnero currently authenticates MCP with a private API key sent in a request header. Use a client that supports those headers, such as Codex or Claude Code, or an agent that can call the REST API. A native OAuth connection for clients that require it has not been released. Do not assume ChatGPT shares Codex configuration.

Last updated: August 29, 2026.
