fix inspector images. add graph setup. link to odyssey

Author: shorgi

docs/source/get-started/index.mdx

@@ -1,6 +1,6 @@
 ---
 title: Get Started
-subtitle: Run Apollo MCP Server
+subtitle: Run Apollo MCP Server for the first time
 ---
 
 <ExperimentalFeature />
@@ -66,7 +66,7 @@ You can run the Apollo MCP Server together with a graph in a local development e
 1. Click **Connect**, then click **List Tool**. Inspector should show the tools from your server.
 
     <img
-      src="../images/mcp-getstarted-inspector.jpg"
+      src="../images/mcp-getstarted-inspector-sse.jpg"
       alt="MCP Inspector connected to running Apollo MCP Server"
       class="screenshot"
       width="600"
@@ -96,7 +96,7 @@ You can run an Apollo MCP Server locally to communicate over stdio.
 1. Click **Connect**, then click **List Tool**. Inspector should show the tools from your server.
 
     <img
-      src="../images/mcp-getstarted-inspector.jpg"
+      src="../images/mcp-getstarted-inspector-stdio.jpg"
       alt="MCP Inspector connected to running Apollo MCP Server"
       class="screenshot"
       width="600"
@@ -157,9 +157,14 @@ You can configure Claude Desktop to use the tools from your MCP server.
     </CodeColumns>
 
 1. Restart Claude, then check that your server's tools are available from the input box.
-1. Ask a question that exercises the tools. 
 
 
 ## Next steps
 
+<OdysseyCallout>
+
+Get more practice with using AI and Apollo with our [interactive tutorials](https://www.apollographql.com/tutorials/browse/?categories=AI).
+
+</OdysseyCallout>
+
 - Try creating tools from operations in persisted queries, via [persisted query manifests](/apollo-mcp-server/guides/#from-persisted-query-manifests) or [GraphOS](/apollo-mcp-server/guides/#from-graphos-managed-persisted-queries).

docs/source/guides/index.mdx

@@ -4,13 +4,14 @@ title: Apollo MCP Server User Guide
 
 <ExperimentalFeature />
 
-A typical workflow for Apollo MCP Server:
-1. Download or build Apollo MCP Server.
+A typical workflow for developing with Apollo MCP Server:
+1. Download (or build) an MCP server binary or container.
+1. Set up the graph that the MCP server sits in front of.
 1. Define the GraphQL operations to expose as MCP tools.
-1. Configure and deploy your MCP server.
-1. Connect your MCP client and use the tools.
+1. Configure and run your MCP server.
+1. Connect an MCP client and run the tools.
 
-## Get server
+## How to get Apollo MCP Server
 
 ### Download binary
 
@@ -34,6 +35,11 @@ You can build an Apollo MCP Server binary from its [source repo](https://github.
 
 TODO
 
+## Set up graph
+
+An Apollo MCP Server must know the GraphQL API of the graph it supports. Thus, you must provide the `--schema` option when running the server. 
+
+The `--schema` option provides the [API schema](/graphos/schema-design/federated-schemas/schema-types#api-schema) of the graph to the server.
 
 ## Define GraphQL operations for tools
 
@@ -130,9 +136,9 @@ Use the `--header` option when running the MCP server to pass the header to the
 
 ### From schema introspection
 
-For use cases where not all operations can be pre-defined, Apollo MCP Server supports tool creation based on graph introspection. This allows AI agents to explore a graph and execute operations dynamically.  
+For use cases where not all operations can be pre-defined, Apollo MCP Server supports tool creation based on introspection of the graph schema. This allows AI agents to explore a graph and execute operations dynamically.  
 
-To enable these schema aware tools, run the MCP server with the `--introspection` option, which exposes two new tools:
+To enable these schema-aware tools, run the MCP server with the `--introspection` option, which exposes two new tools:
 
 * `schema` - returns the GraphQL schema
 * `execute` - executes an operation on the GraphQL endpoint