From 3dcee3972f1d8886d42c8ddc4e57a621878ff44d Mon Sep 17 00:00:00 2001 From: Joseph Caudle Date: Wed, 20 Aug 2025 21:27:05 -0400 Subject: [PATCH 1/4] docs: Add instructions for Claude on Auth guide Using Claude's support documentation and the methods we've been demonstrating on live streams and webinars, this change gives instructions for adding an MCP server to Claude through their Custom Connectors feature. --- docs/source/guides/auth.mdx | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/docs/source/guides/auth.mdx b/docs/source/guides/auth.mdx index 990f80f7..029fdeb5 100644 --- a/docs/source/guides/auth.mdx +++ b/docs/source/guides/auth.mdx @@ -243,6 +243,23 @@ Before continuing, you need to set up the Auth0 client to accept an additional c +### Optional: Connecting to Apollo MCP Server from Claude + +In order to get the full experience of using and MCP server authorization, you'll want to use an LLM of some sort. Anthropic's Claude provides an accessible method of connecting to an MCP server, through [their Custom Connector feature](https://support.anthropic.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp). + +If you'd like to connect your MCP server with Claude, the first thing you need to do is deploy your server behind HTTPS. This is because Claude requires all custom connectors to have URLs that begin with `https`. Whether you do this by providing a local SSL certificate, or deploying to a staging or production environment, is up to you. + +To get your MCP server connected to Claude with a Pro or Max plan, follow these steps: + +1. Navigate to **Settings > Connectors**. +1. Locate the **Connectors** section. +1. Click **Add custom connector** at the bottom of the section. +1. Add the URL to which your MCP server is deployed and a name for the MCP server. +1. Click **Add**. +1. Find your new custom connector and click the **Connect** button. +1. You will be taken to your IdP to log in. Once you log in, you will be redirected back to Claude. +1. Claude will now display the MCP operations available to it under the name you provided and if you give a prompt that would invoke your operations, it should ask permission to access your MCP server. + ## Troubleshooting ### Common Issues From fdb5644adeaa3f138e93c522e7b083dca3cbb02c Mon Sep 17 00:00:00 2001 From: Joseph Caudle Date: Tue, 26 Aug 2025 18:04:53 -0400 Subject: [PATCH 2/4] Improve article structure with heading change Co-authored-by: Michelle Mabuyo --- docs/source/guides/auth.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/guides/auth.mdx b/docs/source/guides/auth.mdx index 029fdeb5..732644d4 100644 --- a/docs/source/guides/auth.mdx +++ b/docs/source/guides/auth.mdx @@ -243,7 +243,7 @@ Before continuing, you need to set up the Auth0 client to accept an additional c -### Optional: Connecting to Apollo MCP Server from Claude +## Step 5: Make requests with an MCP Client (Claude) In order to get the full experience of using and MCP server authorization, you'll want to use an LLM of some sort. Anthropic's Claude provides an accessible method of connecting to an MCP server, through [their Custom Connector feature](https://support.anthropic.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp). From 3f2b96045827197e92c730f1a4cbe9fc6ce2ddbd Mon Sep 17 00:00:00 2001 From: Joseph Caudle Date: Mon, 1 Sep 2025 13:03:01 -0400 Subject: [PATCH 3/4] Add local Claude Desktop configuration instructions --- docs/source/guides/auth.mdx | 39 ++++++++++++++++++++++++------------- 1 file changed, 25 insertions(+), 14 deletions(-) diff --git a/docs/source/guides/auth.mdx b/docs/source/guides/auth.mdx index 732644d4..58244ad9 100644 --- a/docs/source/guides/auth.mdx +++ b/docs/source/guides/auth.mdx @@ -245,20 +245,31 @@ Before continuing, you need to set up the Auth0 client to accept an additional c ## Step 5: Make requests with an MCP Client (Claude) -In order to get the full experience of using and MCP server authorization, you'll want to use an LLM of some sort. Anthropic's Claude provides an accessible method of connecting to an MCP server, through [their Custom Connector feature](https://support.anthropic.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp). - -If you'd like to connect your MCP server with Claude, the first thing you need to do is deploy your server behind HTTPS. This is because Claude requires all custom connectors to have URLs that begin with `https`. Whether you do this by providing a local SSL certificate, or deploying to a staging or production environment, is up to you. - -To get your MCP server connected to Claude with a Pro or Max plan, follow these steps: - -1. Navigate to **Settings > Connectors**. -1. Locate the **Connectors** section. -1. Click **Add custom connector** at the bottom of the section. -1. Add the URL to which your MCP server is deployed and a name for the MCP server. -1. Click **Add**. -1. Find your new custom connector and click the **Connect** button. -1. You will be taken to your IdP to log in. Once you log in, you will be redirected back to Claude. -1. Claude will now display the MCP operations available to it under the name you provided and if you give a prompt that would invoke your operations, it should ask permission to access your MCP server. +In order to get the full experience of using and MCP server authorization, you'll want to use an LLM of some sort. +Anthropic's Claude provides an accessible method of connecting to an MCP server, through [their Custom Connector feature](https://support.anthropic.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp), +which is available to paid Claude subscribers. If you don't have a paid subscription, or want to try Claude out without deploying your MCP Server behind HTTPS (a requirement for Custom Connectors), +follow these steps to get Claude Desktop working locally: + +1. Navigate to **Settings > Developer**. +1. Click **Edit Config** and open `claude_desktop_config.json` in your text editor. +1. If there are any JSON keys other than `mcpServers` in the file, leave them alone, but make sure you add your local MCP Server to that key: + ```json title="claude_desktop_config.json" {3-11} + { + "mcpServers": { + "theSpaceDevs": { + "command": "npx", + "args": [ + "mcp-remote", + "http://127.0.0.1:5000/mcp", + "--transport", + "http-first" + ] + } + } + } + ``` + 1. Quit Claude Desktop and open it back up. Claude will open a browser window for the OAuth flow and turn on the operations configured for your MCP Server. + 1. With the `GetAstronautsCurrentlyInSpace` tool enabled, provide a prompt like "What astronauts are currently in space?" and allow Claude to use your tool, when prompted. ## Troubleshooting From d684aa560326016cd656dce4137414df7a4239fe Mon Sep 17 00:00:00 2001 From: Joseph Caudle Date: Thu, 11 Sep 2025 06:01:09 -0400 Subject: [PATCH 4/4] Change from using Claude to Goose --- docs/source/guides/auth.mdx | 39 +++++++++++++------------------------ 1 file changed, 14 insertions(+), 25 deletions(-) diff --git a/docs/source/guides/auth.mdx b/docs/source/guides/auth.mdx index 58244ad9..771bf226 100644 --- a/docs/source/guides/auth.mdx +++ b/docs/source/guides/auth.mdx @@ -243,33 +243,22 @@ Before continuing, you need to set up the Auth0 client to accept an additional c -## Step 5: Make requests with an MCP Client (Claude) +## Step 5: Make requests with an MCP Client (Goose) In order to get the full experience of using and MCP server authorization, you'll want to use an LLM of some sort. -Anthropic's Claude provides an accessible method of connecting to an MCP server, through [their Custom Connector feature](https://support.anthropic.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp), -which is available to paid Claude subscribers. If you don't have a paid subscription, or want to try Claude out without deploying your MCP Server behind HTTPS (a requirement for Custom Connectors), -follow these steps to get Claude Desktop working locally: - -1. Navigate to **Settings > Developer**. -1. Click **Edit Config** and open `claude_desktop_config.json` in your text editor. -1. If there are any JSON keys other than `mcpServers` in the file, leave them alone, but make sure you add your local MCP Server to that key: - ```json title="claude_desktop_config.json" {3-11} - { - "mcpServers": { - "theSpaceDevs": { - "command": "npx", - "args": [ - "mcp-remote", - "http://127.0.0.1:5000/mcp", - "--transport", - "http-first" - ] - } - } - } - ``` - 1. Quit Claude Desktop and open it back up. Claude will open a browser window for the OAuth flow and turn on the operations configured for your MCP Server. - 1. With the `GetAstronautsCurrentlyInSpace` tool enabled, provide a prompt like "What astronauts are currently in space?" and allow Claude to use your tool, when prompted. +There are many different AI assistants, but a particularly developer-friendly client for interacting with many of them is [Goose](https://block.github.io/goose/). +Goose allows you to choose between many different LLMs and also provides some built in functionality for connecting to MCP servers, called [Extensions](https://block.github.io/goose/docs/getting-started/using-extensions). +To connect the LLM of your choice with your MCP server in Goose CLI, follow these steps after [you've installed and configured Goose](https://block.github.io/goose/docs/getting-started/installation): + +1. In your terminal, run `goose configure`. +1. At the prompt "What would you like to configure?", select "Add Extension". +1. In response to "What type of extension would you like to add?", select “Command Line Extension”. +1. When asked, give your extension a name. Something like `mcp-auth-quickstart` works great here. +1. The command you should enter to the next prompt ("What command should be run?") is `npx mcp-remote http://127.0.0.1:5000/mcp`. +1. Use the default values for the rest of the prompts (e.g. timeout, description, environment variables) and configuration will be complete. +1. To start goose now just type `goose`. As Goose boots, a browser window should open and send you through the auth flow. +1. Log in to your Auth0 instance and authorize your MCP server. After completing this you should have access to your tools. +1. Provide a prompt such as "What astronauts are in space right now?" to make certain the MCP Server is functioning properly. Your LLM should notice it has a suitable tool in your MCP server and give an output about the astronauts found in TheSpaceDevs. ## Troubleshooting