Skip to content

docker updates #6027

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sophiajose-okta wants to merge 5 commits into
base: master
Choose a base branch
from
Open

docker updates #6027

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
336be92
docker updates
sophiajose-okta Mar 9, 2026
1ac3ed0
test build
sophiajose-okta Mar 12, 2026
a5d299b
self review
sophiajose-okta Mar 12, 2026
e4aab6e
test
sophiajose-okta Mar 16, 2026
c1ad99b
further edit
sophiajose-okta Mar 16, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 37 additions & 5 deletions packages/@okta/vuepress-site/docs/guides/mcp-server/main/index.md
View file
Open in desktop
Comment thread
sophiajose-okta marked this conversation as resolved.
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Get started with the Okta Model Context Protocol (MCP) server setup and prerequi
#### What you need

* An [Okta Integrator Free Plan org](https://developer.okta.com/signup) with admin permissions.
* Select an admin role. See [Learn about administrators](https://help.okta.com/okta_help.htm?type=oie&id=administrators-learn-about-admins).
* Select an Okta admin role. See [Learn about administrators](https://help.okta.com/okta_help.htm?type=oie&id=administrators-learn-about-admins).
* The [uv](https://docs.astral.sh/uv/getting-started/installation/) package manager.
* [Python 3.8](https://python.org/downloads) or higher.

Expand All @@ -31,11 +31,43 @@ This guide explains how to initialize the Okta MCP server project and install th

---

## Install and configure the Okta MCP server
## Install the Okta MCP server

### Set up the project
You can install the Okta MCP server using one of the following two methods:

Install and configure the Okta MCP server project for integration with your chosen MCP client.
* [Method 1: Using Docker](#method-1-using-docker)
* [Method 2: Using uv](#method-2-using-uv)

### Method 1: Using Docker

Docker provides a consistent environment without needing to install Python or uv locally.

1. Clone the repository:

```shell
# Clone the Git repo
git clone https://github.com/okta/okta-mcp-server.git

# Change directory
cd okta-mcp-server
```

1. Configure environment variables as follows:

```
cp .env.example .env
```

1. Edit .env and add your Okta credentials.

1. Build and run the environment with Docker Compose:
```
docker-compose up -d
```

### Method 2: Using uv

Use this method for local development or if you prefer to use a lightweight Python environment.

1. Initialize the Okta MCP server project:

Expand All @@ -57,4 +89,4 @@ Install and configure the Okta MCP server project for integration with your chos

## Next steps

[Set up Okta app authentication](/docs/guides/configure-mcp-authentication/main/) for the Okta MCP server to create the required credentials and grant API scopes.
[Set up Okta app authentication](/docs/guides/configure-mcp-authentication/main/) for the Okta MCP server to create the required credentials and grant API scopes.
Loading