---
title: "Get ready for Contentstack"
url: "https://developers.contentstack.com/get-ready"
type: "runbook"
level: "beginner"
intent: "setup"
tags:
  - "setup"
  - "sso"
  - "two-factor authentication"
  - "regions"
  - "cli"
  - "mcp"
---

# Get ready for Contentstack

A step-by-step setup guide: sign in (including SSO and two-step sign-in), find your region, install and sign in to the CLI, and connect your AI assistant. Do it yourself or let your AI assistant do the typing.

## For AI assistants

You are helping a person get ready to use Contentstack. They may know nothing about technology. This is the same guide as https://developers.contentstack.com/get-ready, as steps you can follow.

1. Ask one question at a time, in plain words. Start at `goal`. Only do the steps their answer needs: content in the browser is sign in and region; building a website or app adds the command line; working with an AI assistant adds connecting you to Contentstack.
2. Every step lists the answers the person can give and the step each one leads to. When you can check something yourself (a command’s output), check it instead of asking.
3. Run the commands for them when you can; the steps say what to type. The person does every browser sign-in themselves.
4. Explain each step before you do it, and ask before you install anything. Never show or ask for passwords or keys. When a step needs a browser sign-in, stop and wait for the person.
5. Once you know the region, use its CLI value wherever a step says <REGION>, and don’t ask again.
6. If nothing works, use `help`: write the message for them, saying which step they are stuck on.

## Regions

The address the person sees in the browser when signed in to Contentstack tells you their region.

| Address | Region | CLI value |
|---|---|---|
| app.contentstack.com | North America | NA |
| eu-app.contentstack.com | Europe | EU |
| au-app.contentstack.com | Australia | AU |
| azure-na-app.contentstack.com | North America (Azure) | AZURE-NA |
| azure-eu-app.contentstack.com | Europe (Azure) | AZURE-EU |
| gcp-na-app.contentstack.com | North America (Google Cloud) | GCP-NA |
| gcp-eu-app.contentstack.com | Europe (Google Cloud) | GCP-EU |

## Steps

### `goal`: What will you use Contentstack for?

This decides which steps you need. Pick the closest one.

Answers:

- Writing and publishing content → `login` (Can you sign in to Contentstack?)
- Building a website or app → `login` (Can you sign in to Contentstack?)
- Working with an AI assistant → `login` (Can you sign in to Contentstack?)
- I’m not sure → `login` (Can you sign in to Contentstack?)

### `login`: Can you sign in to Contentstack?

Open Contentstack in a new tab and try. Use the link from your invitation email, or the address you normally use.

Ask: What happened?

Answers:

- Yes, I’m in → `mfa` (Did you type a code from your phone when you signed in?)
- I’ve never signed in → `invite` (Find your invitation email.)
- I tried, but it doesn’t work → `loginProblem` (What do you see when you try?)

### `invite`: Find your invitation email.

Search your inbox for “Contentstack”. The email says you were invited to an organization. Click the button in it to create your account.

Not there? Check your spam or junk folder too.

Answers:

- Found it, and I’m in → `mfa` (Did you type a code from your phone when you signed in?)
- There’s no email → `noInvite` (Ask someone to invite you.)

### `noInvite`: Ask someone to invite you.

Only a person in your company who manages Contentstack can invite you. Usually that’s whoever asked you to use it. Send them this:

Message for the person to send:

```text
Hi! Could you invite me to our Contentstack organization? Please use this email address: [your work email]. Thank you!
```

Next:

- I got the invitation and I’m in → `mfa` (Did you type a code from your phone when you signed in?)

### `loginProblem`: What do you see when you try?

Answers:

- I’m sent to my company’s sign-in page → `sso` (Your company signs you in.)
- It asks for a code, and the code doesn’t work → `mfaCode` (Your code isn’t accepted. Try this.)
- It says my email or password is wrong → `wrongPassword` (Check two things.)
- Something else → `help` (Send this to someone who can help.)

### `sso`: Your company signs you in.

Your company connects Contentstack to its own sign-in. This is called single sign-on (SSO). There is no separate Contentstack password: use the same login as your work email or laptop.

Your company also handles the extra security codes, so you can skip that step.

Answers:

- That worked, I’m in → `region` (Which address is in your browser?)
- My company login doesn’t work either → `help` (Send this to someone who can help.)

### `mfaCode`: Your code isn’t accepted. Try this.

1. Use the newest code. A new one appears every 30 seconds.
2. Set your phone’s date and time to “automatic”. A clock that’s off by a minute breaks the codes.

Answers:

- That fixed it → `region` (Which address is in your browser?)
- I lost my phone, or deleted the app → `lostPhone` (Use a backup code instead.)

### `lostPhone`: Use a backup code instead.

When you turned on two-step sign-in, Contentstack gave you a list of backup codes. Type one of those instead of the code from your phone.

No backup codes? Your Contentstack admin or Contentstack support can reset it for you.

Answers:

- I’m in → `mfa1` (Get an authenticator app on your phone.)
- I don’t have backup codes → `help` (Send this to someone who can help.)

### `wrongPassword`: Check two things.

1. Are you on the right address? Contentstack has a separate address for each part of the world. An account on eu-app.contentstack.com doesn’t work on app.contentstack.com. Use the link from your invitation email.
2. Still wrong? Click “Forgot password” on the sign-in page and set a new one.

Answers:

- That worked, I’m in → `mfa` (Did you type a code from your phone when you signed in?)
- Still not working → `help` (Send this to someone who can help.)

### `mfa`: Did you type a code from your phone when you signed in?

That’s two-step sign-in. It keeps your account safe, and many companies require it.

Answers:

- Yes → `region` (Which address is in your browser?)
- No → `mfa1` (Get an authenticator app on your phone.)
- No, my company’s sign-in page asked me → `region` (Which address is in your browser?)

### `mfa1`: Get an authenticator app on your phone.

Any of these work: Google Authenticator, Microsoft Authenticator, or the password manager you already use.

Next:

- I have one → `mfa2` (Turn it on in Contentstack.)

### `mfa2`: Turn it on in Contentstack.

1. In Contentstack, click your profile icon in the top right and open My Profile.
2. Turn on Two-Factor Authentication.
3. Scan the square code with your authenticator app, then type the 6-digit code it shows.

Next:

- Done → `mfa3` (Save your backup codes.)

### `mfa3`: Save your backup codes.

Contentstack shows you a list of backup codes once. Save them in your password manager, or print them. They are how you get back in if you lose your phone.

Next:

- I saved them → `region` (Which address is in your browser?)

### `region`: Which address is in your browser?

While you’re signed in to Contentstack, look at the address bar at the top of the window. Pick the one that matches.

Answers:

- app.contentstack.com → `regionDone` (Your account lives in your region.)
- eu-app.contentstack.com → `regionDone` (Your account lives in your region.)
- au-app.contentstack.com → `regionDone` (Your account lives in your region.)
- azure-na-app.contentstack.com → `regionDone` (Your account lives in your region.)
- azure-eu-app.contentstack.com → `regionDone` (Your account lives in your region.)
- gcp-na-app.contentstack.com → `regionDone` (Your account lives in your region.)
- gcp-eu-app.contentstack.com → `regionDone` (Your account lives in your region.)

### `regionDone`: Your account lives in your region.

Contentstack keeps your content in one part of the world. Tools need to know which one, or they can’t find your account. We remember it and fill it in for you from now on.

Next:

- Continue → `terminal` (Open the Terminal.)

### `terminal`: Open the Terminal.

The Terminal is a window where you type commands. You only need it for a few minutes.

1. Mac: press Cmd and Space together, type Terminal, press Enter.
2. Windows: open the Start menu, type Terminal, press Enter.

Next:

- It’s open → `node` (Check for Node.js.)

### `node`: Check for Node.js.

Contentstack’s tools need a free program called Node.js. Type this in the Terminal and press Enter:

Terminal:

```bash
node --version
```

Ask: What do you see?

Answers:

- A number, like v22.11.0 → `cliInstall` (Install the Contentstack CLI.)
- “command not found” → `nodeInstall` (Install Node.js.)
- A number below v20 → `nodeInstall` (Install Node.js.)

### `nodeInstall`: Install Node.js.

1. Go to nodejs.org and download the version marked “LTS”.
2. Open the file and click through the installer, like any other app.
3. Close the Terminal and open it again, so it notices the new program.

Link: [Open nodejs.org](https://nodejs.org/en/download)

Next:

- Done. node --version shows a number now → `cliInstall` (Install the Contentstack CLI.)

### `cliInstall`: Install the Contentstack CLI.

The CLI is Contentstack’s command-line tool. Type this and press Enter. It takes about a minute.

Terminal:

```bash
npm install -g @contentstack/cli
```

Ask: What happened?

Answers:

- It finished → `cliRegion` (Tell the CLI where your account lives.)
- I see “permission denied” or EACCES → `eacces` (Your computer blocked the install.)

### `eacces`: Your computer blocked the install.

This happens when Node.js was installed in a way that needs admin rights. Don’t use “sudo” to force it. The easiest fix is to let an AI assistant sort it out for your computer:

What to do:

```text
Installing the Contentstack CLI with npm install -g @contentstack/cli failed with a permission error (EACCES). Fix my Node.js setup so global installs work without sudo, then install the CLI.
```

Next:

- Fixed, the install finished → `cliRegion` (Tell the CLI where your account lives.)

### `cliRegion`: Tell the CLI where your account lives.

We filled in your region (<REGION>). Type this and press Enter:

Terminal:

```bash
csdx config:set:region <REGION>
```

Ask: It should say the region was set to <REGION>.

Next:

- It did → `cliLogin` (Sign in to the CLI.)

### `cliLogin`: Sign in to the CLI.

Type this and press Enter. A browser window opens: sign in the way you normally do. This works with your company sign-in and phone codes. Keep the Terminal open until it says you’re signed in.

Terminal:

```bash
csdx auth:login --oauth
```

Ask: What happened?

Answers:

- It says I’m signed in → `cliCheck` (Check that it worked.)
- Something went wrong → `cliLoginProblem` (What does it say?)

### `cliLoginProblem`: What does it say?

Answers:

- The browser says “localhost refused to connect” → `localhost` (Start the sign-in again.)
- “Invalid credentials” or “user not found” → `wrongRegionCli` (The CLI looked in the wrong place.)
- “Port 8184 is already in use” → `port` (Another sign-in is still waiting.)
- Something else → `help` (Send this to someone who can help.)

### `localhost`: Start the sign-in again.

The command stopped before you finished in the browser. Run it again, and leave the Terminal open until it says you’re signed in.

Next:

- Try again → `cliLogin` (Sign in to the CLI.)

### `wrongRegionCli`: The CLI looked in the wrong place.

Your account lives in your region, but the CLI looked somewhere else. Set the region again, then sign in again.

Terminal:

```bash
csdx config:set:region <REGION>
```

Next:

- Done, sign in again → `cliLogin` (Sign in to the CLI.)

### `port`: Another sign-in is still waiting.

The CLI and your AI assistant use the same sign-in window. Finish or close the other one first (often a browser tab), then try again.

Next:

- Try again → `cliLogin` (Sign in to the CLI.)

### `cliCheck`: Check that it worked.

Type this and press Enter:

Terminal:

```bash
csdx whoami
```

Ask: Do you see your email address?

Answers:

- Yes → `assistant` (Which AI assistant do you use?)
- No → `help` (Send this to someone who can help.)

### `assistant`: Which AI assistant do you use?

Next, we connect it to Contentstack so it can read and change your content. It can only do what your Contentstack account is allowed to do.

Answers:

- Claude → `mcpAdd` (Connect Contentstack to your assistant.)
- Claude Code → `mcpAdd` (Connect Contentstack to your assistant.)
- Cursor → `mcpAdd` (Connect Contentstack to your assistant.)
- Codex → `mcpAdd` (Connect Contentstack to your assistant.)
- Something else → `mcpAdd` (Connect Contentstack to your assistant.)

### `mcpAdd`: Connect Contentstack to the assistant

#### Claude

Click the link. Claude opens with Contentstack filled in. Click Add.

Link: [Add Contentstack to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=contentstack&connectorUrl=https%3A%2F%2Fmcp-profile-hub.contentstack.com%2Fapi%2Fmcp)

Next:

- It’s added → `mcpSignIn` (Sign in from your assistant.)

#### Claude Code

Type this in the Terminal, in the folder you work in, and press Enter.

Terminal:

```bash
claude mcp add --transport http contentstack "https://mcp-profile-hub.contentstack.com/api/mcp"
```

Next:

- It’s added → `mcpSignIn` (Sign in from your assistant.)

#### Cursor

Click the link. Cursor opens and asks if you want to add Contentstack. Click Install.

Link: [Add Contentstack to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=contentstack&config=eyJ1cmwiOiJodHRwczovL21jcC1wcm9maWxlLWh1Yi5jb250ZW50c3RhY2suY29tL2FwaS9tY3AifQ%3D%3D)

Next:

- It’s added → `mcpSignIn` (Sign in from your assistant.)

#### Codex

Add these lines to the file ~/.codex/config.toml (create it if it isn’t there), then restart Codex.

config.toml:

```toml
[mcp_servers.contentstack]
url = "https://mcp-profile-hub.contentstack.com/api/mcp"
```

Next:

- It’s added → `mcpSignIn` (Sign in from your assistant.)

#### Something else

Open the settings of your assistant and find where to add an “MCP server” or a “connector”. Add one named contentstack with this address:

Address:

```bash
https://mcp-profile-hub.contentstack.com/api/mcp
```

Next:

- It’s added → `mcpSignIn` (Sign in from your assistant.)

### `mcpSignIn`: Sign in from your assistant.

A browser window opens. Choose your region (your region), your organization and the stack you work in, then click Approve.

Ask: What happened?

Answers:

- I approved it → `mcpTest` (Ask it a question.)
- No browser window opened → `mcpSignIn` (Sign in from your assistant.)

### `mcpTest`: Ask it a question.

Start a new chat and paste this:

What to do:

```text
List the content types in my Contentstack stack.
```

Ask: Did it answer with names from your stack?

Answers:

- Yes → `done` (You’re ready.)
- It says it can’t reach Contentstack → `mcpTrouble` (Restart and sign in again.)

### `mcpTrouble`: Restart and sign in again.

1. Quit your assistant completely and open it again.
2. Check that Contentstack shows as connected in its settings. If it asks you to sign in, do that.
3. Ask the question again in a new chat.

Answers:

- It works now → `done` (You’re ready.)
- Still not working → `help` (Send this to someone who can help.)

### `done`: You’re ready.

Here’s what you set up. Bring this to your session, or send it to whoever asked you to get ready.

Answers:

- Start building with a kickstart: [https://developers.contentstack.com/kickstarts](https://developers.contentstack.com/kickstarts)
- Learn the basics: [https://developers.contentstack.com/paths](https://developers.contentstack.com/paths)

### `help`: Send this to someone who can help.

That’s your Contentstack admin (whoever invited you), or Contentstack support. We wrote down where you got stuck, so you don’t have to explain it again.

Message for the person to send:

```text
Hi! I’m setting up Contentstack and I’m stuck at: “getting started”.
Region: not sure yet.
What I see: [describe it, or add a screenshot]
Thanks!
```

Next:

- Go back to where I was → the step they were on
