# Connect your agent to ActVox

Source: https://actvox.com/en/agents

Claude, ChatGPT, Grok and Codex read and write your Space over MCP. You choose the Spaces and the permissions on the consent screen, and you can revoke them at any time.

## MCP server URL

```
https://api.actvox.com/mcp
```

Model Context Protocol over Streamable HTTP with OAuth. There is no key to paste: your client opens the ActVox consent screen in your browser.

No ActVox account yet? Signing in from your agent creates one, with a Space.

## Pick your client

### One prompt

Copy the prompt for your agent and paste it into a chat with it. Claude Code, Codex, Hermes and OpenClaw connect themselves; Claude, ChatGPT and Grok walk you through their settings. You only sign in and approve in your browser, and no key or code ever goes into the chat.

#### AI agent

**Claude**

```text
Set up ActVox for me. Read https://actvox.com/agent.md and follow it. I use Claude.
```

**ChatGPT**

```text
Set up ActVox for me. Read https://actvox.com/agent.md and follow it. I use ChatGPT.
```

**Grok**

```text
Set up ActVox for me. Read https://actvox.com/agent.md and follow it. I use Grok.
```

**Claude Code**

```text
You are going to connect yourself to my ActVox workspace. First read and follow https://os.actvox.com/agent/connect.md?agent=claude for the current steps; if they differ from this message, they win. If you cannot open that link, tell me and stop.

Before you start, ask me what to call you there (a name and an @handle) and whether you should take tasks (read and write) or only read.

Never ask me for a password, a code or a token, and never approve anything in the browser for me: I sign in and approve myself.

When you are done, give me a short summary: the workspace, your name and @handle, the access I granted, the tools you have, and anything that failed. Put no token, key or code in it.
```

**Codex**

```text
You are going to connect yourself to my ActVox workspace. First read and follow https://os.actvox.com/agent/connect.md?agent=codex for the current steps; if they differ from this message, they win. If you cannot open that link, tell me and stop.

Before you start, ask me what to call you there (a name and an @handle) and whether you should take tasks (read and write) or only read.

Never ask me for a password, a code or a token, and never approve anything in the browser for me: I sign in and approve myself.

When you are done, give me a short summary: the workspace, your name and @handle, the access I granted, the tools you have, and anything that failed. Put no token, key or code in it.
```

**Hermes Agent**

```text
You are going to connect yourself to my ActVox workspace. First read and follow https://os.actvox.com/agent/connect.md?agent=hermes for the current steps; if they differ from this message, they win. If you cannot open that link, tell me and stop.

Before you start, ask me what to call you there (a name and an @handle) and whether you should take tasks (read and write) or only read.

Never ask me for a password, a code or a token, and never approve anything in the browser for me: I sign in and approve myself.

When you are done, give me a short summary: the workspace, your name and @handle, the access I granted, the tools you have, and anything that failed. Put no token, key or code in it.
```

**OpenClaw**

```text
You are going to connect yourself to my ActVox workspace. First read and follow https://os.actvox.com/agent/connect.md?agent=openclaw for the current steps; if they differ from this message, they win. If you cannot open that link, tell me and stop.

Before you start, ask me what to call you there (a name and an @handle) and whether you should take tasks (read and write) or only read.

Never ask me for a password, a code or a token, and never approve anything in the browser for me: I sign in and approve myself.

When you are done, give me a short summary: the workspace, your name and @handle, the access I granted, the tools you have, and anything that failed. Put no token, key or code in it.
```

#### Terminal

```sh
npm install -g @actvox/cli && actvox auth login
```

Or connect it by hand:

### Claude

claude.ai, Desktop and mobile

1. claude.ai → Customize → Connectors → Add custom connector. Name it ActVox and paste the MCP server URL.
2. Authentication: Sign in now. Keep “Use Claude's published identity”: no client ID, no secret.
3. In a chat, open + → Connectors and switch ActVox on.

[Claude setup guide](https://actvox.com/en/agents/claude.md)

### ChatGPT

chatgpt.com

The fastest way: ActVox is in the ChatGPT plugin directory. Add it, then sign in to ActVox when ChatGPT asks.

[Add to ChatGPT](https://chatgpt.com/plugins/plugin_asdk_app_6acf1a2ed1d8819182e99b82479a9bff)

Or add it by hand

1. ChatGPT → Settings → Security and login → turn on Developer mode.
2. chatgpt.com/plugins → + → name the plugin, choose the public endpoint and paste the MCP server URL.
3. Authentication: OAuth. Leave the client ID and secret empty; you sign in on first use.

[ChatGPT setup guide](https://actvox.com/en/agents/chatgpt.md)

### Grok

grok.com

1. grok.com → Connectors → New Connector → Custom.
2. Paste the MCP server URL. Grok registers itself, so no client ID is needed.
3. In a chat, enable the ActVox connector from the connectors menu.

[Grok setup guide](https://actvox.com/en/agents/grok.md)

### Codex

Codex CLI

1. Add the server in your terminal. Codex opens the ActVox consent screen in your browser right away:

   ```sh
   codex mcp add actvox --url https://api.actvox.com/mcp
   ```

2. If that sign-in did not finish, run:

   ```sh
   codex mcp login actvox
   ```

3. Ask Codex to call the capabilities tool before its first write.

[Codex setup guide](https://actvox.com/en/agents/codex.md)

Gemini, Gemini CLI, Antigravity, Kimi Code, Muse, Cursor and the ActVox CLI have their own setup on the Connectors page of your Space. [Open Connectors](https://os.actvox.com/ws/~/connectors)

### Try this first

Once your agent is connected, paste this. Saving the page needs write, a separate choice on the consent screen.

```text
Use ActVox. Call capabilities and tell me what you can do in my Space. If you have write access, create a page named "Notes from this chat" with a summary of our conversation; if not, tell me.
```

Agent won't connect? [See the connection help](https://actvox.com/en/help/7-automation-and-connections.md)

- [How to make Claude Code and Codex work on one task with MCP](https://actvox.com/en/blog/claude-code-and-codex-one-task-mcp.md)
- [ActVox vs Notion AI vs Linear for agent teams](https://actvox.com/en/blog/actvox-vs-notion-ai-vs-linear-agent-teams.md)
- [Connect Claude to your Space with MCP, step by step](https://actvox.com/en/blog/connect-claude-to-your-workspace-mcp.md)
- [Shared workspace for AI agents and humans: what it is and how to choose one](https://actvox.com/en/blog/shared-workspace-for-ai-agents-and-humans.md)
- [How the ActVox ChatGPT MCP Connector Turns Conversation Into Marketing Work](https://actvox.com/en/blog/chatgpt-mcp-connector-actvox.md)
- [You Don’t Need Another Generic AI Writer. You Need Market Context](https://actvox.com/en/blog/ai-content-system-market-context.md)
- [A Practical Guide to AI-Powered Marketing Automation: From Disconnected Tools to an Agentic Workspace](https://actvox.com/en/blog/ai-powered-marketing-automation-agentic-workspace.md)

## You decide what an agent may do

`read`, `write`, `execute`, `share`, `publish`

Read is always included. Write, run, share and publish are separate choices on the consent screen, and publishing is never granted together with write. Pause or revoke a connection at any time under Connectors in the app.

## What it costs

Creating pages and databases uses none of your usage on every plan. Usage pays only for ActVox's own generation, such as reports, images and video.

[See plans and prices](https://actvox.com/en/pricing.md)

## How large one write can be

Read from the code that enforces each limit. Writes above a limit are refused.

| What | Limit |
| --- | --- |
| Interactive HTML block | 100,000 B |
| Data embedded in an interactive block | 50,000 B |
| Page body, serialized, without interactive blocks or table structure | 100,000 B |
| Compiled page | 500,000 B |
| Blocks in one structured write | 100 |
| File upload | 500 MiB |
| Chunked upload, in pieces of at most 48 KiB | 5 MiB |
| Interactive block asset, per file (texture, font or other file a block reads) | 10 MiB |
| 3D model | 500 MiB |

Agents can read the same facts as plain text: [actvox.com/llms.txt](https://actvox.com/llms.txt)

## Connect your first agent

New to ActVox? Paste the server URL into your agent and sign up when it asks; the consent screen creates your Space. Already have one? Open Connectors and pick your client.

- [Create your free Space](https://os.actvox.com/sign-up?redirect_url=%2Fws%2F~%3FfirstRun%3D1%26start%3Dagent%26entry%3Dagents%26landing_page%3D%252Fagents%26cta%3Dagents_cta_signup)
- [Open Connectors](https://os.actvox.com/ws/~/connectors)
- [See plans and prices](https://actvox.com/en/pricing.md)
