Configuration
The MCP Jira server is configured using environment variables. These can be set directly in your environment, via a .env file, or through Docker/Docker Compose configuration.
Required Environment Variables
| Variable |
Description |
Example |
JIRA_URL |
The base URL of your Jira instance |
https://your-domain.atlassian.net |
JIRA_USERNAME |
The email address or username for your service account |
service-account@example.com |
JIRA_API_TOKEN |
An Atlassian API token |
YOUR_API_TOKEN |
Optional Environment Variables
| Variable |
Description |
Default |
Example |
READONLY_MODE |
If set to true, disables all tools that create, update, or modify data in Jira |
false |
true |
Generating an API Token
- Log in to your Atlassian account.
- Go to Account Settings -> Security -> Create and manage API tokens.
- Create a new token and copy it to use as
JIRA_API_TOKEN.