Skip to main content

Installation

This guide will help you install and configure the MCMP Java SDK in your Java project.

Requirements

Java Version

Java 11 or higher is required for the MCMP Java SDK

Build Tools

Maven 3.6+ or Gradle 6.0+ recommended

Maven Installation

Add the MCMP Java SDK dependency to your pom.xml:
<dependencies>
    <dependency>
        <groupId>com.mcmp</groupId>
        <artifactId>mcmp-java-sdk</artifactId>
        <version>1.0.0</version>
    </dependency>
</dependencies>

Repository Configuration

If you’re using a private repository, add the MCMP repository:
<repositories>
    <repository>
        <id>mcmp-releases</id>
        <url>https://repo.mcmp.app/repository/maven-public/</url>
        <releases>
            <enabled>true</enabled>
        </releases>
        <snapshots>
            <enabled>false</enabled>
        </snapshots>
    </repository>
</repositories>

Gradle Installation

Add the dependency to your build.gradle:
dependencies {
    implementation 'com.mcmp:mcmp-java-sdk:1.0.0'
}

Repository Configuration

Add the MCMP repository to your build.gradle:
repositories {
    maven {
        url 'https://repo.mcmp.app/repository/maven-public/'
    }
}

Manual Installation

If you prefer to install the JAR manually:
  1. Download the latest JAR from releases
  2. Add it to your project’s classpath
  3. Ensure all required dependencies are available

Verification

Test your installation with a simple example:
import com.mcmp.sdk.McmpClient;

public class InstallationTest {
    public static void main(String[] args) {
        try {
            McmpClient client = McmpClient.builder().build();
            System.out.println("MCMP Java SDK installed successfully!");
        } catch (Exception e) {
            System.err.println("Installation failed: " + e.getMessage());
        }
    }
}

Dependencies

The MCMP Java SDK includes the following dependencies:
  • OkHttp 4.x for HTTP communication
  • Jackson for JSON serialization/deserialization
  • Java 11+ CompletableFuture for async operations
  • ExecutorService for background tasks
  • SLF4J for logging abstraction
  • Compatible with Logback, Log4j2, and other logging frameworks

Troubleshooting

Ensure the MCMP Java SDK JAR is in your classpath and all dependencies are resolved.
Check for conflicting versions of OkHttp or Jackson in your project dependencies.
Verify you have access to the MCMP Maven repository and your network allows HTTPS connections.

Next Steps

1

Authentication

Configure API keys and authentication
2

Basic Usage

Learn the basics of the SDK