Content
# Confluence MCP Server
This is an MCP (Model Context Protocol) server that provides page search and retrieval functions using the Confluence API.
## Features
### Tools
| Tool | Description |
|------|------|
| `confluence_search` | Searches for pages in Confluence using CQL |
| `confluence_get_page` | Retrieves the body by page ID (converts HTML to text) |
## Installation
```bash
npm install
npm run build
```
### Issuing a Personal Access Token
1. Go to Confluence settings > Personal Access Tokens
2. Click "Create token"
3. Enter the token name and create it
## Claude Desktop Configuration
Add the following to `claude_desktop_config.json`:
Path to the above file:
macOS standard:
```
~/Library/Application Support/Claude/claude_desktop_config.json
```
```json
{
"mcpServers": {
"confluence": {
"command": "node",
"args": ["/path/to/confluence-mcp/dist/server.js"],
"env": {
"CONFLUENCE_BASE_URL": "https://your-domain.atlassian.net",
"CONFLUENCE_PAT": "your-personal-access-token"
}
}
}
}
```
> You can set it directly in the `env` field as above instead of the `.env` file.
## Usage Example
1. Run the mcp server.
2. Turn on claude desktop and check if the `+` connector is connected.
(If it is not turned on at this time, completely close and run claude desktop)
3. Then search in the claude desktop chat window as follows.
**Page Search:**
```
Search for related documents in Confluence
Find content about playMcp
...
```