Let's run Apollo MCP Server for the first time! You will:
Understand an MCP Server example
Run an MCP Server example
Connect an MCP client (Claude Desktop) to the MCP Server
Want a quick overview of what we can do with Apollo MCP Server? Check out this YouTube video or blog post about what we'll cover in more detail here.
What You'll BuildIn this quickstart, you'll create a working AI integration where Claude Desktop can query space-related data through GraphQL. By the end, you'll be able to:
Ask Claude natural questions like "Who are the astronauts currently in space?" or "What rocket launches are coming up?"
See Claude use MCP tools to fetch real-time data from The Space Devs API
Understand how GraphQL operations become AI-accessible tools
Here's what the end result looks like:
You: "Tell me about the astronauts currently in space" Claude: [Uses GetAstronautsCurrentlyInSpace tool] "There are currently 7 astronauts aboard the International Space Station..."
This example uses a pre-built space API, but the same approach works with any GraphQL API - including your own production services.
If you learn best with videos and exercises, this
interactive courseteaches you how to set up Apollo MCP Server and create tools from
GraphQL
operations.
PrerequisitesClone the Apollo MCP Server repo
Install Apollo Rover CLI v0.35 or later
This guide uses an MCP example from the Apollo MCP Server repo. The example uses APIs from The Space Devs , and it defines a federated graph and the GraphQL operations of the graph to expose as MCP tools.
The example files located in graphql/TheSpaceDevs/
include:
A federated graph connecting to The Space Devs API
supergraph.yaml
is a supergraph configuration file used by the Rover CLI
4 pre-built operations that become your AI tools:
ExploreCelestialBodies
- Search planets, moons, and stars
GetAstronautDetails
- Get info about specific astronauts
GetAstronautsCurrentlyInSpace
- See who's in space right now
SearchUpcomingLaunches
- Find upcoming rocket launches
From the root directory of your local repo, run rover dev
to start a local graph with an MCP Server:
This command:
Starts a local graph using the supergraph configuration
Starts an MCP Server with the --mcp
flag
Provides a configuration file with MCP Server options
See the command reference for a list of available configuration options.
Start MCP Inspector to verify the server is running:
Open a browser and go to http://127.0.0.1:6274
In Inspector:
Select Streamable HTTP
as the Transport Type
Enter http://127.0.0.1:5000/mcp
as the URL
Click Connect, then List Tools
You should see the tools from your server listed.
We're using Claude as our AI Assistant (acting as our MCP Client).
First, locate your Claude configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
Then add the following configuration
Open Claude's JSON config file and add this configuration:
You need Node v18 or later installed for
mcp-remote
to work. If you have an older version of Node, uninstall it and install the latest version from
nodejs.org.
Restart Claude.
Let's verify everything is working:
In Claude Desktop, type: "What MCP tools do you have available?"
Claude should list tools like ExploreCelestialBodies
, GetAstronautDetails
, etc.
Try a real query: "Who are the astronauts currently in space?"
Claude should use the GetAstronautsCurrentlyInSpace
tool and return current data
If Claude can't see the tools:
Ensure you restarted Claude Desktop after editing the config
Check that your MCP server is still running
Verify the port numbers match between your server and Claude config
Error: "Port 5000 is already in use"
Solution: Kill any existing processes using port 5000 or specify a different port with the transport.port
option or APOLLO_MCP_TRANSPORT__PORT
env variable
Error: "Failed to load supergraph configuration"
Solution: Verify you're running the command from the repo root directory
Solution: Check that the path to supergraph.yaml
is correct
Error: "Failed to connect to server"
Solution: Ensure the MCP server is running (check terminal output)
Solution: Verify you're using the correct URL (http://127.0.0.1:5000/mcp
)
Solution: Check if your firewall is blocking the connection
Problem: Claude doesn't recognize the tools
Solution: Verify the config file path is correct for your OS
Solution: Ensure the JSON is properly formatted (no trailing commas)
Solution: Try restarting Claude Desktop completely
Problem: "Connection refused" errors
Solution: Check if the MCP server is still running
Solution: Verify the port numbers match in both the server and Claude config
Problem: "MCP thespacedevs: Server disconnected" errors
Solution: Uninstall older versions of Node. mcp-remote
only works with Node v18 or later.
Solution: Restart Claude Desktop
Error: "Operation not found"
Solution: Verify the operation files exist in the specified path
Solution: Check that the operation names match exactly
Error: "Schema validation failed"
Solution: Ensure your GraphQL operations match the schema
Solution: Check for syntax errors in your operation files
If you're still having issues:
Check the Apollo MCP Server GitHub issues
Join the Apollo Community MCP Server Category
Contact your Apollo representative for direct support
See the user guide to learn how to create tools from:
When you are ready, deploy the MCP server.
Additional ResourcesCheck out these blog posts to learn more about Apollo MCP Server:
Advanced Options Alternative ways to run the MCP Server Using STDIO TransportYou can run the MCP Server using STDIO transport instead of Streamable HTTP. This is useful for certain environments or when you need more direct control over the server process.Previous
Apollo MCP Server
Next
Installing Apollo MCP Server
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4