Connect your AI Agents to Confluence in minutes

Merge lets you securely connect your agents to Confluence and thousands of tools instantly

Available tools

get_blogposts

Get blog posts from Confluence with optional space filtering

get_blogpost

Get a specific blog post with full content by ID

create_blogpost

Create a new blog post in Confluence - requires space_id, title, and body_value

update_blogpost

Update an existing blog post in Confluence - requires blogpost_id, title, body_value, and version_number

delete_blogpost

Delete a blog post from Confluence

get_pages

Get pages from Confluence with optional space filtering

get_page

Get a specific page with full content by ID

create_page

Create a new page in Confluence - requires space_id, title, and body_value

update_page

Update an existing page in Confluence

delete_page

Delete a page from Confluence

get_page_footer_comments

Get footer comments for a specific Confluence page

get_page_inline_comments

Get inline comments for a specific Confluence page

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11
Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}
Copy Code
Copied!

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }
Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}
Copy Code

FAQs on using Merge's Confluence  MCP server

FAQs on using Merge's Confluence  MCP server

How can I use the Confluence MCP server?

Here are some use cases worth implementing:

  • Incident response coordination: When an incident occurs, your agent can pull runbooks and troubleshooting guides from Confluence while simultaneously creating incident tickets in Jira and posting status updates to Slack
  • Code review context enrichment: Your agent can fetch design documents and technical specifications from Confluence when reviewing pull requests in GitHub. For instance, when a developer submits a PR, it can automatically retrieve the related docs from Confluence and add them as context in the PR comments
  • Sales enablement from product knowledge: Your agent can pull product documentation, competitive positioning, and feature descriptions from Confluence to assist sales teams in Salesforce or Slack
  • Support ticket enrichment: Your agent can search Confluence for known issues, troubleshooting guides, and solution articles while processing support tickets in apps like Zendesk or Intercom
  • Sprint planning with documentation context: Your agent can retrieve product requirements, technical constraints, and past retrospective notes from Confluence while helping teams plan sprints in Jira or Linear

What are popular tools for Confluence’s MCP server?

Here are some popular tools across data types:

Blog posts

  • <code class="blog_inline-code">get_blogposts</code>
  • <code class="blog_inline-code">get_blogpost</code>
  • <code class="blog_inline-code">create_blogpost</code>
  • <code class="blog_inline-code">update_blogpost</code>

Pages

  • <code class="blog_inline-code">search_pages</code>
  • <code class="blog_inline-code">get_pages</code>
  • <code class="blog_inline-code">create_page</code>
  • <code class="blog_inline-code">get_page_inline_comments</code>

Spaces

  • <code class="blog_inline-code">create_space</code>
  • <code class="blog_inline-code">get_space</code>
  • <code class="blog_inline-code">get_space_content</code>
  • <code class="blog_inline-code">list_all_spaces</code>

What makes Merge Agent Handler’s Confluence MCP server better than alternative Confluence MCP servers?

When using Confluence through Merge Agent Handler, developers benefit from platform-level capabilities that apply across all connectors:

  • Enterprise-grade security and DLP: All tool inputs and outputs are scanned by a configurable security gateway that can block, redact, or mask sensitive data before it reaches Confluence or your agent. Rules can be applied globally, per connector, per Tool Pack, or by region, with real-time alerts when violations occur
  • Authentication and credential management: Merge Agent Handler manages user onboarding, OAuth flows, credential storage, and token refresh so agents never manage secrets directly. Agent Handler also supports both individual and shared authentication models, automatically manages token rotation, and validates credentials
  • Real-time observability and audit trails: Every tool call is logged with full context, including the user, tool and arguments used, response data, status codes, and timestamps. Server logs are fully-searchable by user, Tool Pack, connector, date, and rule violations, making it easy to drill down into specific incidents for debugging and compliance auditing
  • Evaluation before production: Tools can be validated in the Evaluation Suite to ensure correct behavior and expected outcomes before deployment. You can set up structured test prompts, validate that agents call the correct tools with appropriate parameters, simulate failure cases like expired tokens, and test across different scenarios

Can I set security rules for Confluence tool calls in Merge Agent Handler?

Yes, you can set a wide range of security rules for Confluence tool calls in Merge Agent Handler.

For example, you can:

  • Block internal project codenames in searches. Prevent your agents from searching Confluence spaces for confidential project codenames or internal code words that should remain restricted
  • Redact employee IDs before creating pages. Automatically strip employee identification numbers before your agents create or update Confluence pages or comments
  • Log when agents access restricted spaces. Track and audit whenever your agents read from or search within specific Confluence spaces designated as confidential or executive-only
  • Block customer PII in page updates. Prevent your agents from adding customer names, phone numbers, or addresses to Confluence documentation or wiki pages
  • Redact database connection strings. Automatically remove database credentials, server addresses, or connection strings before they're written to Confluence technical documentation

How can I start using Merge Agent Handler’s Confluence MCP server?

Here's how to get started with Merge Agent Handler's Confluence MCP server:

1. Create your Agent Handler account. Go to Merge Agent Handler's sign up page to register for free and access the platform dashboard.

2. Configure a Tool Pack. Tool Packs define which connectors and tools your agent can use. From the Tool Packs section, click Create Tool Pack, include Confluence as a connector, and choose between Individual or Shared authentication depending on your requirements.

3. Register a User identity. Navigate to Registered Users and create an entry; this represents the identity (either human or system) that will perform actions through your agent. Agent Handler handles Confluence authentication automatically with a guided flow, so you don't need to build custom OAuth logic.

4. Test in the Sandbox environment. Before going live, verify that everything works as expected. Access your Tool Pack's Sandbox and experiment with Confluence tool calls like searching spaces, retrieving pages, or updating documentation.

5. Integrate with your agent application. Connect your agent to Agent Handler through one of these approaches:

  • Model Context Protocol: Copy the MCP server configuration from your Tool Pack settings and add it to your agent's MCP client setup. This grants your agent immediate access to all Confluence tools through the protocol
  • Direct API integration: Use Agent Handler's REST API to list available tools and invoke them programmatically. You'll need your API key, Tool Pack ID, and Registered User ID for requests

Explore other MCP servers built and managed by Merge

airtable
Airtable
asana
Asana
calendly
Calendly
figma
Figma
github
GitHub
gmail
Gmail
gong
Gong
google_calendar
Google Calendar
google_drive
Google Drive
greenhouse
Greenhouse
hubspot
HubSpot
intercom
Intercom
jira
Jira
jira_service_management
Jira Service Management
linear
Linear
microsoft_teams
Microsoft Teams
notion
Notion
onedrive
OneDrive
outlook
Outlook
pipedrive
Pipedrive
quickbooks_online
QuickBooks Online
sapsf
SAP SuccessFactors
salesforce
Salesforce
servicenow
ServiceNow
sharepoint
SharePoint
shopify
Shopify
slack
Slack
stripe
Stripe
weather
Weather
wikipedia
Wikipedia
zendesk
Zendesk
zoom
Zoom

Ready to try it out?

Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now