# Connecting Claude Desktop with Adaptive Graph of Thoughts
This guide will help you set up Claude Desktop to use the Adaptive Graph of Thoughts Graph of Thoughts server for enhanced scientific reasoning.
## Prerequisites
1. Adaptive Graph of Thoughts server running (either locally or in a Docker container)
2. Claude Desktop application installed on your computer
3. Access to Claude 3.7 Sonnet model
## Step 1: Configure the MCP Connection in Claude Desktop
1. Open Claude Desktop
2. Navigate to Settings (gear icon)
3. Go to "Tools" or "Integrations" section
4. Click "Add Tool" or "Add Integration"
5. Select "MCP Integration" or "Custom Server"
6. Import the `claude_mcp_config.json` file from this repository
Alternatively, you can manually configure the connection with the following settings:
- **Name**: Adaptive Graph of Thoughts MCP Integration
- **Description**: Integrates Claude with the Adaptive Graph of Thoughts server for advanced scientific reasoning
- **Icon**: 🔬
- **Endpoint**: http://localhost:8000/mcp
- **Method**: POST
- **Headers**: Content-Type: application/json
## Step 2: Test the Connection
1. In Claude Desktop, create a new conversation
2. Ensure the Claude 3.7 Sonnet model is selected
3. Enable the Adaptive Graph of Thoughts integration from the tools panel
4. Ask a scientific reasoning question, for example:
- "What is the relationship between climate change and ocean acidification?"
- "Explain how mRNA vaccines work and compare them to traditional vaccines."
- "What are the current theories about dark matter and dark energy?"
## Step 3: Using the Integration
When you ask a question, Claude Desktop will:
1. Send your query to the Adaptive Graph of Thoughts MCP server
2. The server will process it through the Graph of Thoughts reasoning process
3. Return a structured response with:
- The answer to your question
- The reasoning trace showing the thought process
- The graph state representation of the reasoning
## Troubleshooting
If you encounter issues:
1. Check that the Adaptive Graph of Thoughts server is running by visiting http://localhost:8000/health
2. Verify your network connection and firewall settings
3. Check the Adaptive Graph of Thoughts server logs for error messages
4. Ensure the Claude Desktop app has the correct MCP configuration
## Advanced Configuration
The `config/claude_mcp_config.json` file is primarily used to define the Adaptive Graph of Thoughts service for Claude Desktop. It specifies details like the service name, description, endpoint URL, and capabilities.
Parameters that control the reasoning process at runtime, such as:
- The level of detail in responses (e.g., including the reasoning trace or full graph state)
- Specific operational parameters for the ASR-GoT query (e.g., confidence thresholds, specific stages to run if that feature were implemented)
are generally sent by the MCP client (Claude Desktop) as part of the `params` object in the JSON-RPC request to the `asr_got.query` method. For details on available query parameters, refer to the `MCPASRGoTQueryParams` schema defined in `src/adaptive_graph_of_thoughts/api/schemas.py`. Modifying `claude_mcp_config.json` does not alter these runtime behaviors.
## Detailed Logging
To help identify errors during the 8-stage process, detailed logging has been added. Each stage logs its start and end, along with any significant events or errors. This logging can be found in the server logs.
## Error Handling
Error handling has been implemented for each stage to catch and log exceptions. If an error occurs, it will be logged with details about the stage and the nature of the error. This information can be used to diagnose and fix issues.
## Input Validation
Input parameters are validated to ensure they meet expected formats. If invalid parameters are detected, an error will be logged and an appropriate response will be returned to the client.
