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

Open
wants to merge 5 commits into
base: develop
Choose a base branch
from
Open

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

Changes from all commits
Commits
Show all changes
5 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
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-auth0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -225,6 +225,23 @@

</ExpansionPanel>

## Step 5: Make requests with an MCP Client (Goose)

Check warning on line 228 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L228 

Headings should use sentence casing, not title casing.

```suggestion
## 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.

Check warning on line 230 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L230 

This change corrects a typo ('and' to 'an') and replaces the vague phrase 'of some sort' with more direct and helpful language.

```suggestion
To get the full experience of using an MCP server with authorization, you'll need to use a Large Language Model (LLM).
```
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/).

Check notice on line 231 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L231 

Use an opinionated voice by prescribing a specific path instead of presenting multiple options. This phrasing is more direct and authoritative.

```suggestion
A developer-friendly client for interacting with AI assistants 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).

Check notice on line 232 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L232 

The suggested phrasing is more direct and authoritative. Avoid unopinionated language like 'allows you to choose'.

```suggestion
Goose supports multiple LLMs and provides built-in functionality called [Extensions](https://block.github.io/goose/docs/getting-started/using-extensions) for connecting to MCP servers.
```
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):
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I understand that this is a non-trivial instruction as prerequisite. Configuring Goose requires some important decisions, but I don't know if it's worth getting into the details on that in this guide.


1. In your terminal, run `goose configure`.
1. At the prompt "What would you like to configure?", select "Add Extension".

Check warning on line 236 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L236 

Use bold formatting for the names of interactive UI elements like buttons or selectable options, instead of quotation marks.

```suggestion
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”.

Check warning on line 237 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L237 

Use bold formatting for the names of interactive UI elements like buttons or selectable options, instead of quotation marks.

```suggestion
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.

Check notice on line 238 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L238 

The suggested phrasing is more direct and authoritative. Avoid overly colloquial phrases like 'works great here'.

```suggestion
1. When asked, give your extension a name, such as <code>mcp-auth-quickstart</code>.
```
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`.

Check warning on line 239 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L239 

Use the imperative mood for instructions to make them more direct and actionable.

```suggestion
1. For the "What command should be run?" prompt, enter <code>npx mcp-remote http://127.0.0.1:5000/mcp</code>.
```
1. Use the default values for the rest of the prompts (e.g. timeout, description, environment variables) and configuration will be complete.

Check notice on line 240 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L240 

Favor the active voice and present tense. 'to complete the configuration' is more direct than 'configuration will be complete'.

```suggestion
1. Use the default values for the remaining prompts (e.g., timeout, description, environment variables) to complete the configuration.
```
1. To start goose now just type `goose`. As Goose boots, a browser window should open and send you through the auth flow.

Check warning on line 241 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L241 

Avoid using the word 'just'. Also, use the present tense ('opens', 'directs') for clarity and immediacy.

```suggestion
1. To start Goose, type <code>goose</code>. As Goose boots, a browser window opens and directs you through the authentication flow.
```
1. Log in to your Auth0 instance and authorize your MCP server. After completing this you should have access to your tools.

Check notice on line 242 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L242 

Favor the present tense. 'you have access' is more direct than 'you should have access'.

```suggestion
1. Log in to your Auth0 instance and authorize your MCP server. After you complete this step, you 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.

Check warning on line 243 in docs/source/guides/auth-auth0.mdx

View check run for this annotation

Apollo Librarian / AI Style Review

docs/source/guides/auth-auth0.mdx#L243 

Use stronger, more direct verbs like 'verify' instead of 'make certain'. Favor the present tense ('notices', 'provides') over conditional phrasing ('should notice').

```suggestion
1. Provide a prompt such as "What astronauts are in space right now?" to verify the MCP Server is functioning properly. Your LLM notices it has a suitable tool in your MCP server and provides an output about the astronauts found in TheSpaceDevs.
```

## Troubleshooting
Copy link
Contributor Author

Choose a reason for hiding this comment

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

There are some issues that can arise if any of the above steps go wrong, but I'm not sure how much of them we want to document in this Troubleshooting section. Namely, the ~/.mcp-auth folder may cause Goose to hang on boot and might need to be deleted. If everything goes cleanly, this shouldn't happen, but this and a few other things I ran into while testing this out seem like easy ways to get into trouble for new users.


### Common Issues
Expand Down