Skip to content

docs: Add instructions for Goose as an LLM client on Auth guide #275

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Sep 23, 2025
Merged

docs: Add instructions for Goose as an LLM client on Auth guide #275

Changes from 1 commit
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
3dcee39
docs: Add instructions for Claude on Auth guide
jcaudle Aug 21, 2025
fdb5644
Improve article structure with heading change
jcaudle Aug 26, 2025
3f2b960
Add local Claude Desktop configuration instructions
jcaudle Sep 1, 2025
d684aa5
Change from using Claude to Goose
jcaudle Sep 11, 2025
726342e
Merge branch 'develop' into add-claude-to-auth-guide
jcaudle Sep 11, 2025
5f1f480
fix: heading style
mabuyo Sep 23, 2025
516e67c
edits for simplicity and directness
mabuyo Sep 23, 2025
3c3d138
use an easy-to-skim table for prompts + answers
mabuyo Sep 23, 2025
e1eed61
clarify goose configure with LLM provider
mabuyo Sep 23, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions docs/source/guides/auth.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -243,6 +243,23 @@ Before continuing, you need to set up the Auth0 client to accept an additional c

</ExpansionPanel>

### 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).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are we not able to use the local dev config to point to the deployed server? We have to use this paid feature?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We could use local dev config, but that requires using the Claude Desktop app and Watson has been demoing this method on live streams. I can rework this section to recommend that method if we want to use it in our docs.


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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's try to be a bit more helpful here. For example we can link to our deployment docs.

And find another one for "providing a local SSL certificate".


To get your MCP server connected to Claude with a Pro or Max plan, follow these steps:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be farther up in the section since it's a pre-requisite to have their Pro or Max plan.


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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Recommend giving a prompt/question they can use that reflects the example project they cloned.


## Troubleshooting

### Common Issues
Expand Down