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

# How to set up the Atoti MCP Server in Java

> How to add the Atoti MCP Server to an Atoti Java project via the `starter-ai-mcp-server` and `mcp-server-spring` Maven dependencies, with steps to verify the MCP Server initializes and its `POST /mcp` endpoint is accessible.

<Info>
  ### Atoti Intelligence SDK

  This is part of the Atoti Intelligence SDK offer.
</Info>

This guide explains how to add the MCP Server to an Atoti Java project. Read more about best practices for configuring MCP across a deployment in [What are the best practices for MCP configuration?](../introduction#what-are-the-best-practices-for-mcp-configuration).

## Prerequisites

Before setting up the MCP Server, ensure the following requirements are met:

* Java project
* A license including the Atoti Intelligence Extension tier, which itself requires Essentials

## Add the MCP Server dependencies to the project

Add the following to `pom.xml`:

```xml theme={"languages":{"custom":["/engine/python-sdk/6.2/languages/pycon.tmLanguage.json"]}} theme={"languages":{"custom":["/engine/python-sdk/6.2/languages/pycon.tmLanguage.json"]}}
<dependency>
  <groupId>com.activeviam.springboot</groupId>
  <artifactId>starter-ai-mcp-server</artifactId>
  <version>${activepivot.version}</version>
</dependency>
```

```xml theme={"languages":{"custom":["/engine/python-sdk/6.2/languages/pycon.tmLanguage.json"]}} theme={"languages":{"custom":["/engine/python-sdk/6.2/languages/pycon.tmLanguage.json"]}}
<dependency>
  <groupId>org.springframework.ai</groupId>
  <artifactId>spring-ai-starter-mcp-server-webmvc</artifactId>
  <version>${spring-ai.version}</version>
</dependency>
```

## Verify the setup

After adding the dependencies, verify that the MCP Server is available:

1. Build the project
2. Start the Atoti application
3. Check the application logs for MCP Server initialization messages
4. Verify that the MCP Server endpoint is accessible, at `POST /mcp`

<Note>
  `POST /mcp` is the Streamable HTTP transport, which the starter configures by default. The older
  server-sent events transport at `/sse` is deprecated for removal in Spring AI 2.0.0; use `/mcp`
  everywhere. See [MCP transport](./configure-oauth2-self-issued#which-mcp-transport-does-self-issued-mode-use).
</Note>

## Related reading

After setting up the MCP Server, proceed to:

* [How to set up the Atoti MCP Server in Python](./setup-python)
* [Connect with Postman](./connect-with-postman) to test the MCP Server
* [Connect with Claude](./connect-with-claude) to integrate with Claude AI
* [Configure OAuth 2.1 discovery](./configure-oauth2-discovery) to enable browser-based SSO
  against your IdP for MCP clients
* [Add custom tools](../custom-tools) to extend functionality
* [MCP credentials page](./mcp-credentials-page) to mint long-lived bearer tokens for MCP clients (opt-in feature, disabled by default)
* [How connecting to other MCP Servers works](../connect-to-other-servers/how-it-works) to use
  another server's tools as this server's own, with setup guides for
  [Java](../connect-to-other-servers/setup-java) and [Python](../connect-to-other-servers/setup-python)