> ## Documentation Index
> Fetch the complete documentation index at: https://docs.caplena.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP (Model Context Protocol)

> Connect Caplena to any MCP-compatible client and query your feedback data in natural language.

Caplena supports the **Model Context Protocol (MCP)**, an open standard that lets you connect your Caplena projects directly to any MCP-compatible client. Once connected, you can ask questions about your feedback data in plain language, without opening Caplena at all.

MCP works with a growing range of clients — **Claude Desktop**, Cursor, and others. The walkthrough below uses **Claude Desktop** as an example, but the same Caplena MCP URL works in any client that supports custom connectors.

## What This Lets You Do

Instead of opening Caplena, building filters, and reading through charts, you just ask a question and get an answer. For example:

* "What are the top complaints in my NPS project this week?"
* "How has sentiment changed over the past month in my support feedback project?"
* "Summarize the most common themes across my Q1 and Q2 projects."

The real power lies in combining Caplena data with other tools and files in the same conversation:

* "Get the top 3 issues in Germany, France and the US and create a 4-slide PowerPoint deck from this with our corporate template."
* "Find app issues mentioned in the past 2 days and create a Jira ticket for every one of them."
* "For each of the three strategic priorities outlined in the Strategy.docx file, create an executive summary of the voice of the customer related to the initiative, both qualitative and quantitative."

<Tip>
  The real power comes from combining the Caplena MCP with other connectors in your AI app, such as Atlassian, Microsoft 365, or Jira, so you can pull customer insights directly into documents, tickets, and emails without switching tools.
</Tip>

This is especially useful for:

* **Stakeholders and non-analysts** who use an MCP client but don't work in Caplena day-to-day — they can get answers without needing to know how to navigate the platform.
* **Combining Caplena data with other context** — the client can look at your feedback data alongside a document, spreadsheet, or email in the same conversation.

## Before You Start

* You have a Caplena account with at least one project set to **Live**.
* You have an **MCP-compatible client** installed — this guide uses **Claude Desktop** as the example.

<Tip>
  Only projects set to "Live" are accessible via the MCP connection. You can check this on the project overview page, if a project shows as "not discoverable", just enable Live mode. [Learn how →](/get-started/project-settings/setting-a-project-to-live)
</Tip>

## Step 1: Enable MCP in Caplena

1. In Caplena, go to **Settings → Integrations**.
2. Under **Connected Outbound Accounts**, find the MCP tile and click **Enable**.
3. A modal appears. Click **Enable** again to confirm.
4. Copy the **MCP URL** shown in the modal. This is the URL you'll add to your MCP client.

<Frame>
  <img src="https://mintcdn.com/caplena-32172960/f2rnYDTA58YE-8u7/images/Screenshot-2026-05-27-at-16.45.47.png?fit=max&auto=format&n=f2rnYDTA58YE-8u7&q=85&s=0d43be78e094fb0ecd79646fb8fa5a08" alt="Screenshot 2026 05 27 At 16 45 47" width="2500" height="1344" data-path="images/Screenshot-2026-05-27-at-16.45.47.png" />
</Frame>

## Step 2: Add Caplena as a Custom Connector

These steps use **Claude Desktop** as the example client. In another MCP client, add a custom connector or server using the same Caplena MCP URL.

1. Open **Claude Desktop** and go to **Settings → Connectors**.
2. Click **Add custom connector**.

<Frame>
  <img src="https://mintcdn.com/caplena-32172960/f2rnYDTA58YE-8u7/images/Screenshot-2026-05-27-at-16.47.01.png?fit=max&auto=format&n=f2rnYDTA58YE-8u7&q=85&s=c6ddee0586d419ab9dbd7723b1dad985" alt="Screenshot 2026 05 27 At 16 47 01" width="2612" height="1428" data-path="images/Screenshot-2026-05-27-at-16.47.01.png" />
</Frame>

3. In the modal that appears, fill in:
   * **Name:** Caplena
   * **URL:** the MCP URL you copied in Step 1
4. Click **Add**.

<Frame>
  <img src="https://mintcdn.com/caplena-32172960/f2rnYDTA58YE-8u7/images/Screenshot-2026-05-27-at-16.48.45.png?fit=max&auto=format&n=f2rnYDTA58YE-8u7&q=85&s=a73d0865be1d727ec89ed313f9b89a1e" alt="Screenshot 2026 05 27 At 16 48 45" width="1670" height="1310" data-path="images/Screenshot-2026-05-27-at-16.48.45.png" />
</Frame>

## Step 3: Authorize the Connection

1. Caplena appears in your connectors list. Click **Connect**.
2. You'll be redirected to Caplena. If you're not already logged in, you'll be asked to sign in.
3. An authorization screen appears asking you to grant the client access to your Caplena data. In Claude Desktop this reads **Authorize Claude?** — click **Authorize**.
4. You'll be sent back to your client and should see a **"Connected to Caplena"** confirmation message.

<Frame>
  <img src="https://mintcdn.com/caplena-32172960/f2rnYDTA58YE-8u7/images/Screenshot-2026-05-27-at-16.49.51.png?fit=max&auto=format&n=f2rnYDTA58YE-8u7&q=85&s=d787694546cfa5ec21d1914edee4da03" alt="Screenshot 2026 05 27 At 16 49 51" width="2368" height="1278" data-path="images/Screenshot-2026-05-27-at-16.49.51.png" />
</Frame>

## Step 4: Start Querying Your Data

In your MCP client, try: *"List the projects that you can access on Caplena."*

The client will ask for your permission to use its Caplena tools. Grant access when prompted — in Claude Desktop, click **Always allow** (you may be asked twice: once to query Caplena, once to use the Retrieve tool).

<Frame>
  <img src="https://mintcdn.com/caplena-32172960/guH-hKljMU7WLpB2/images/Screenshot-2026-05-27-at-16.52.16.png?fit=max&auto=format&n=guH-hKljMU7WLpB2&q=85&s=658596de5347b9379f64bf0753ec38a0" alt="Screenshot 2026 05 27 At 16 52 16" width="2436" height="1032" data-path="images/Screenshot-2026-05-27-at-16.52.16.png" />
</Frame>

After a moment, you'll see all your Live projects listed with their names and row counts.

<Frame>
  <img src="https://mintcdn.com/caplena-32172960/guH-hKljMU7WLpB2/images/Screenshot-2026-05-27-at-16.55.07.png?fit=max&auto=format&n=guH-hKljMU7WLpB2&q=85&s=aa437dbc9aa923d60a8c72c260c579e3" alt="Screenshot 2026 05 27 At 16 55 07" width="3066" height="700" data-path="images/Screenshot-2026-05-27-at-16.55.07.png" />
</Frame>

<Note>
  By default, your MCP client may ask for your approval each time it queries Caplena. You can change this to **Always allow** to skip the confirmation on every request.
</Note>

## Video Walkthrough

<iframe src="https://www.loom.com/embed/4ddbd4ef58c944438a1243496602ece3" title="Loom video player" frameborder="0" className="w-full aspect-video rounded-xl" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />
