You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/source/quickstart.mdx
+13-15Lines changed: 13 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,29 +9,28 @@ This guide walks you through the process of creating, running and configuring an
9
9
10
10
## Prerequisites
11
11
12
-
-[Rover CLI](/rover/getting-started) v0.36 or later
12
+
-[Rover CLI](/rover/getting-started) v0.36 or later. We'll use Rover to initialize a project and run the MCP server.
13
13
-[Node.js](https://nodejs.org/) v18 or later (for `mcp-remote`)
14
14
-[Claude Desktop](https://claude.ai/download) or another MCP-compatible client
15
15
16
16
## Step 1: Create an MCP server
17
17
18
-
The [Rover CLI](/rover) is the fastest way to create an Apollo MCP Server using `rover init --mcp`, which creates a project in your local directory.
19
-
20
18
Run the interactive initialization command:
21
19
22
-
```bash
20
+
```bash showLineNumbers=false
23
21
rover init --mcp
24
22
```
25
23
26
-
The CLI wizard guides you through several prompts. Select **Create MCP tools from a new Apollo GraphOS project** and **Apollo graph with Connectors (connect to REST services)** as your starting point.
24
+
The CLI wizard guides you through several prompts.
25
+
26
+
Select **Create MCP tools from a new Apollo GraphOS project** and **Apollo graph with Connectors (connect to REST services)** as your starting point.
27
27
28
28
You'll also need to select your organization and give your project a name and ID.
29
29
30
30
The wizard shows all files that will be created, including:
31
31
32
32
- MCP server configuration files
33
33
- GraphQL schema and operations
34
-
- Client configuration (Claude Desktop)
35
34
- Docker setup for (optional) deployment
36
35
37
36
Type `Y` to confirm and create your project files.
@@ -40,7 +39,7 @@ Type `Y` to confirm and create your project files.
40
39
41
40
You can start your MCP server locally with `rover dev`.
42
41
43
-
### Load Environment Variables and Start MCP Server
42
+
Choose the environment-specific command to load environment variables from the provided `.env` file and start the MCP server.
44
43
45
44
<Tabs>
46
45
@@ -51,24 +50,24 @@ You can start your MCP server locally with `rover dev`.
rover dev --supergraph-config supergraph.yaml --mcp .apollo/mcp.local.yaml
61
59
```
62
60
</Tab>
61
+
63
62
</Tabs>
64
63
65
64
You should see some output indicating that the GraphQL server is running at `http://localhost:4000` and the MCP server is running at `http://127.0.0.1:5050`.
66
65
67
66
### Verify with MCP Inspector
68
67
69
-
Before connecting to Claude, verify your MCP server is working. In a new terminal window, run:
1. Verify GraphQL operations are listed as available tools
217
216
1. Test a query using one of your configured operations
218
217
219
-
220
-
## Configuration Options
218
+
## Configuration options
221
219
222
220
When using Apollo MCP Server, you can customize the server configuration through your `config.yaml` file - see the [YAML Config Reference page](./config-file) for a list of options.
0 commit comments