> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP client setup

> Connect Codex, Claude, or another MCP host to Apostra's account-resolved endpoint.

The [connection quickstart](/v3/quickstart) has copyable commands for Codex and
Claude Code, plus setup guidance for other Streamable HTTP clients.

Use the single account-resolved endpoint:

```text theme={null}
https://api.apostra.com/mcp/v3
```

## Claude and Cowork

Regular Claude and Cowork use the hosted MCP connector. In Claude's connector
settings, add a custom connector with the URL above and complete OAuth in the
browser. Your plan and organisation settings must allow custom connectors;
an administrator may need to enable access.

Ask the connected assistant to call `get_status` and report the active account
and its readiness without making changes. Follow [Manage ads](/v3/manage-ads)
for buying, selling, and reporting workflows.

The `apostra-developer` plugin is for **Codex and Claude Code**. Its installation
commands run in those coding tools, not in regular Claude or Cowork. Use the
[developer quickstart](/v3/quickstart) when you want to build software.

## Existing connections

If you already use a v2 Buyer or Seller connector, add v3 as a separate
connection while checking your workflow. Selecting v3 in these docs does not
change a client configuration or grant additional permissions. A plugin that
already supplies the endpoint does not need a second manually added connector.

The server can close a connection after 30 minutes or during a deploy. Reuse
the existing MCP session when reconnecting. Do not design long-running work
around one open tool call. If a call is interrupted, its response may be lost
even when the operation was accepted. Re-read state and follow that tool's
idempotency contract before retrying. See [Build an agent](/v3/build-an-agent).

<Card title="Full agent-host guide" icon="book" href="/v2/setup/built-for-agents">
  Review host-specific setup, credential handling, connection lifetime, and
  stable v2 connector behavior.
</Card>

<Card title="Create a white-label ChatGPT app" icon="comments" href="/v2/reference/white-label-chatgpt-app">
  Connect the v3 endpoint in ChatGPT Developer mode, record a review demo, and
  prepare the customer-branded submission handoff.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.