# Connect Your AI to Marke.st — MCP Sign-In and Your First Link

## Document Directory

This paste contains 3 documents:

- [README.md](https://marke.st/p/01M33S86SF35M481JPJ78QCY24/README.md) ← (current)
- [prompts/first-link.md](https://marke.st/p/01M33S86SF35M481JPJ78QCY24/prompts/first-link.md)
- [connect.sh](https://marke.st/p/01M33S86SF35M481JPJ78QCY24/connect.sh) (code)

---

## README.md

# Connect once. Publish from a prompt.

**MARKE.ST WORKFLOW / MCP + OAUTH / START HERE**

Your assistant can draft the document **and save it somewhere useful**. Instead of copying a long answer into another editor, connect Marke.st and ask for a document set and a link.

```text
Add the Marke.st MCP server
           ↓
Sign in in your browser and review access
           ↓
Ask for a document + where to save it
           ↓
Open the real link returned by Marke.st
```

## 1 · Use the Marke.st MCP address

Connect to Marke.st using this remote MCP server URL:

```text
https://marke.st/mcp
```

Use this exact address in your connector settings. It is a server URL, not an API key. Complete authentication through the browser sign-in when prompted; never put your password, access token, or OAuth secret into a document or chat prompt.

## 2 · Connect in Claude

In Claude, open **Customize → Connectors**, choose **+ → Add custom connector**, give it the name **Marke.st**, and enter `https://marke.st/mcp`. Add it, then use **Connect** and complete the browser sign-in when offered. Review the permissions before approving. Enable the connector in the conversation where you will use it.

For a managed workspace, an owner may need to add the connector first. Labels and availability can change; [Anthropic's current connector guide](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) is the setup reference. Use optional OAuth client credentials only when your provider supplies them—not values guessed by an assistant.

## Prefer Claude Code?

Add the remote server:

```bash
claude mcp add --transport http markest https://marke.st/mcp
```

Start Claude Code and use `/mcp` to inspect the connection and complete authentication when required. See [Claude Code's MCP documentation](https://code.claude.com/docs/en/mcp). Do not register a second connection unnecessarily if an existing one is already working.

## Prefer Codex CLI?

```bash
codex mcp add markest --url https://marke.st/mcp
codex mcp login markest
```

The login command is for an OAuth-enabled server; adding the server may already start sign-in. See [the official Codex MCP guide](https://developers.openai.com/codex/mcp). CLI installation and permissions are prerequisites, not actions performed by this page.

## ChatGPT is a separate setup

Use the Marke.st app/plugin available to your account, or your authorized custom-app setup. A local Codex configuration is not automatically a hosted ChatGPT connection. Available write tools depend on the client and workspace. Consult [OpenAI's MCP setup reference](https://developers.openai.com/codex/mcp) and [custom-app requirements](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt); do not assume that a search-only connection can publish.

## 3 · Try a harmless read first

```text
Use the Marke.st connector to search for a paste titled "My first guide".
Do not create, edit, delete, or share anything yet.
Tell me whether the connection worked and whether a matching paste exists.
```

## 4 · Make your first document

Open [the publishing prompt](prompts/first-link.md), copy it into a connected conversation, and review the result. Start with fictional content and an unlisted link. **Unlisted is accessible to anyone with the link; it is not private.**

| What success looks like | What it does not prove |
|---|---|
| The tool returns an actual paste ID and URL | A model-written URL alone is not evidence of an upload |
| Reading that paste returns the expected content | It does not prove every browser interaction was tested |
| Visibility is reported accurately | An approval request is not completed public publication |

## Permission troubleshooting

A missing create tool can mean the connection is read-only. An authentication error can require reconnecting in the client. A public-visibility request can require browser approval in Marke.st. Check the actual result rather than repeatedly creating duplicates.

**Setup provenance:** the Marke.st MCP address is `https://marke.st/mcp`. The linked official client guides are the references for client setup. No new end-to-end OAuth login was performed for this tutorial.

---
[Browse the Marke.st example gallery](https://marke.st/p/01M33R91CGF13BZC4KDXT2M418) · [Create your own document set](https://marke.st)