How to set up the Atoti MCP Server

Atoti Intelligence SDK

This is part of the Atoti Intelligence SDK offer.

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?.

Prerequisites

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

Java project
The Atoti application has a valid AI license

Add the MCP Server dependencies to the project

Add the following to pom.xml:

<dependency>
  <groupId>com.activeviam.springboot</groupId>
  <artifactId>starter-ai-mcp-server</artifactId>
  <version>${activepivot.version}</version>
</dependency>

<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:

Build the project
Start the Atoti application
Check the application logs for MCP Server initialization messages
Verify that the MCP Server endpoint is accessible, at POST /mcp

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.

After setting up the MCP Server, proceed to:

Connect with Postman to test the MCP Server
Connect with Claude to integrate with Claude AI
Configure OAuth 2.1 discovery to enable browser-based SSO against your IdP for MCP clients
Add custom tools to extend functionality
MCP credentials page to mint long-lived bearer tokens for MCP clients (opt-in feature, disabled by default)

Introduction to Atoti Intelligence

Releases and Upgrades

User Guide

Developer Guide

How to set up the Atoti MCP Server

Atoti Intelligence SDK

Prerequisites

Add the MCP Server dependencies to the project

Verify the setup

​Atoti Intelligence SDK

​Prerequisites

​Add the MCP Server dependencies to the project

​Verify the setup

​Related reading

Atoti Intelligence SDK

Prerequisites

Add the MCP Server dependencies to the project

Verify the setup

Related reading