# Optimizely setup for PopMCP

You paste one value into PopMCP: a personal access token, made in Optimizely under Profile, API Access. You then choose one project or all of them. Data Platform, CMS and Content Marketing Platform use their own credentials, which are optional and go under More options.

- Auth: API credentials
- Setup time: 1 min
- API base URL: https://api.optimizely.com
- Credentials screen: https://app.optimizely.com/v2/profile/api
- Provider docs: https://docs.optimizely.com/feature-experimentation/api

## Before you begin

- A login on an Optimizely Feature or Web Experimentation account. Anyone with a role can make a token for themselves: administrators, project owners, editors and viewers
- For Data Platform: access to Settings, APIs in Optimizely Data Platform, for the Private key
- For CMS (SaaS): access to Settings, API Keys in your CMS
- For Content Marketing Platform: access to Admin, Apps and Webhooks, to register an app

## Get your credentials

### 1. Open API Access in your profile

Sign in to [Optimizely](https://app.optimizely.com/v2/profile/api), open your Profile and choose the API Access tab. The link goes straight there.

Screen: https://app.optimizely.com/v2/profile/api

### 2. Name the token and copy it

Click Generate New Token, enter a name such as PopMCP, click Create, then copy the token. Do this now: once you leave the API Access tab, Optimizely no longer shows it.

Screen: https://app.optimizely.com/v2/profile/api

### 3. Paste the token into PopMCP and choose the project

In PopMCP, paste the token into Personal access token and connect. PopMCP checks it and lists your projects. Choose one project, and the connection is locked to it, or choose All projects so the AI can work across the account and names the project each time. An account with one project skips that choice.

### 4. Optional: add your other Optimizely products

Open More options in the same form. For Data Platform, paste the Private key from Settings, APIs: PopMCP finds your region. For CMS (SaaS), go to Settings, API Keys, click Create API Key and paste its Client ID and Secret. For Content Marketing Platform, go to Admin, Apps and Webhooks, click Register App and paste its client ID and client secret. If you only use one of these products, leave the token empty.

## Fields PopMCP asks for

- Personal access token (accessToken): In Optimizely: Profile, API Access, Generate New Token. Give it a name, choose Create, then copy it. Needed for Feature and Web Experimentation. Stored encrypted.
- Data Platform private key (odpApiKey): In Optimizely Data Platform: Settings, APIs. Use the Private key, not the Public key or Tracker ID. Your region is found for you.
- CMS client ID (cmsClientId): In your CMS: Settings, API Keys, Create API Key. It shows a Client ID and a Secret once.
- CMS secret (cmsClientSecret): Goes with the CMS client ID
- Content Marketing Platform client ID (cmpClientId): In Content Marketing Platform: Admin, Apps and Webhooks, Register App. It gives you a client ID and a client secret.
- Content Marketing Platform client secret (cmpClientSecret): Goes with the client ID above

## Verify

PopMCP marks the Optimizely connection Verified with your project's name and records your name, email and account. For a Data Platform key it also records the region. Asking the AI to list your projects, or the flags in one, returns them.

## Troubleshooting

### Optimizely did not accept this personal access token

Cause: undefined

Fix: The token was revoked or was not copied whole. Tokens cannot be viewed twice, so generate a new one under Profile, API Access and paste that.

### This token can no longer open the project

Cause: undefined

Fix: You were removed from the project, or it was archived. Ask an administrator to add you back, or connect another project.

### Optimizely Data Platform did not accept this key

Cause: undefined

Fix: It has to be the Private key from Settings, APIs in Data Platform. The Public key, also called the Tracker ID, can only send data.

### CMS or Content Marketing Platform did not accept this client id and secret

Cause: undefined

Fix: Copy both again, or create a new API key or app. Each pair has to be complete.

### A flag tool answers not found

Cause: undefined

Fix: Flags only exist in Feature Experimentation projects, and are named by key rather than name. Check that is_flags_enabled is true on the project, and list the flags to see their keys.

### Optimizely is limiting requests

Cause: undefined

Fix: The main API allows 100 requests a minute, 20 for results. The Flags API allows 120 a minute and 2 a second. Wait a minute and try again.

---

Source: https://www.docs.popmcp.com/docs/integrations/optimizely/