---
title: Getting Started Proxying
description: Start MockServer as an HTTP/HTTPS proxy, configure clients to send traffic through it, and analyse or verify recorded requests and responses.
shortTitle: Getting Started
layout: page
pageOrder: 1
section: 'Proxy'
subsection: true
sitemap:
  priority: 0.9
  changefreq: 'monthly'
  lastmod: 2019-11-10T08:00:00+01:00
---

<p style="width: 35%; float: right; margin-right: 5%"><img src="../images/more_detail_available_message.png" alt="Note: this page is a high level overview of each topic, more detail is available for each topic on a linked page." style="float: right; max-width: 100%;"></p>

<p>To use MockServer to analysis an existing system:</p>

<ol start="0">
    <li><a href="#start_mockserver">Start MockServer</a></li>
    <li><a href="#configure_clients">Configure Clients</a></li>
    <li>Run Scenarios</li>
    <li><a href="#analysing_behaviour">Analyse Behaviour</a></li>
</ol>

<p style="width: 59%; margin-top: 0; padding-top: 0;"><img src="../images/recording_requests_with_mockserver_proxy.png" alt="Mocking service dependencies with MockServer" style="max-width:100%;"></p>

<p>To use MockServer to verify requests:</p>

<ol start="0">
    <li><a href="#start_mockserver">Start MockServer</a></li>
    <li><a href="#configure_clients">Configure Clients</a></li>
    <li>Run Your Test Scenarios</li>
    <li><a href="/proxy/verification.html">Verify Requests</a></li>
</ol>

<p style="width: 59%; margin-top: 0; padding-top: 0;"><img src="../images/system_under_test_with_mockserver_proxy_different_numbering.png" alt="Mocking service dependencies with MockServer" style="max-width:100%;"></p>

<p>For example code see the <a target="_blank"href="https://github.com/mock-server/mockserver-monorepo/tree/master/examples" rel="noopener noreferrer">code examples folder</a> in the git repository.</p>

<p><strong>Inspecting AI agent traffic?</strong> If you want to see the HTTPS calls that Claude Code, OpenCode, or Python AI libraries send to LLM APIs and MCP servers, see <a href="/mock_server/ai_traffic_inspection.html">Inspect AI Agent Traffic</a>. It covers proxy setup, CA trust, and per-tool configuration for AI tools.</p>

<a id="start_mockserver" class="anchor" href="#start_mockserver">&nbsp;</a>

<h2>0. Start MockServer</h2>

{% include_subpage ../mock_server/_includes/running_mock_server_summary.html %}

<a id="configure_clients" class="anchor" href="#configure_clients">&nbsp;</a>

<h2>1. Configure Clients</h2>

<p>The page on <a href="/proxy/configuring_sut.html">configuring clients</a> gives full details on how to configure clients to proxy requests via MockServer and includes code examples for the following clients:</p>

<ul>
    <li><a href="/proxy/configuring_sut.html#java_jdk_http_url_connection">Java JDK HttpURLConnection</a></li>
    <li><a href="/proxy/configuring_sut.html#apache_http_client">Apache HttpClient</a></li>
    <li><a href="/proxy/configuring_sut.html#spring_rest_template">Spring RestTemplate</a></li>
    <li><a href="/proxy/configuring_sut.html#google_http_client">Google HTTP Client</a></li>
    <li><a href="/proxy/configuring_sut.html#jetty_http_client">Jetty HttpClient</a></li>
    <li><a href="/proxy/configuring_sut.html#jersey_client">Jersey Client</a></li>
    <li><a href="/proxy/configuring_sut.html#grizzly_async_http_client">Grizzly AsyncHttpClient</a></li>
    <li><a href="/proxy/configuring_sut.html#socks_jvm_configuration">Java Virtual Machine Network Stack</a></li>
    <li><a href="/proxy/configuring_sut.html#apple_mac_http_https">Apple Mac HTTP & HTTPS (i.e. Chrome, Safari, Firefox, etc)</a></li>
    <li><a href="/proxy/configuring_sut.html#socks_mac_os">Apple Mac Network Stack (i.e. SOCKS)</a></li>
</ul>


<a id="analysing_behaviour" class="anchor" href="#analysing_behaviour">&nbsp;</a>

<h2>3. Analysing Behaviour</h2>

{% include_subpage _includes/analysing_behaviour.html %}

<h2>3. Verify Requests</h2>

{% include_subpage ../mock_server/_includes/verification_summary.html %}