> ## Documentation Index
> Fetch the complete documentation index at: https://docs.typewise.app/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tools

> An integration isn't responding

**Alert**: "AI integration not responding"

**Impact**: The AI Agent can't use this integration to help customers.

<Note>
  Core channels (email, chat) still work. This alert is about AI tool
  integrations only.
</Note>

## Quick diagnosis

| Symptom             | Likely cause                       | Fix                                         |
| ------------------- | ---------------------------------- | ------------------------------------------- |
| All tools failing   | Server down                        | [Check server status](#check-server-status) |
| Auth errors in logs | Token expired                      | [Update credentials](#update-credentials)   |
| Timeouts            | Server overloaded or network issue | Check server resources                      |
| SSL errors          | Certificate expired                | Renew your SSL certificate                  |

## Check server status

<Steps>
  <Step title="Verify process">
    Verify your MCP server process is running.
  </Step>

  <Step title="Check resources">
    Check server resources (CPU, memory, disk).
  </Step>

  <Step title="Review deployments">
    Review recent deployments for breaking changes.
  </Step>

  <Step title="Test endpoint">
    Test the endpoint directly:

    ```bash theme={null}
    curl -I https://your-mcp-server.com/mcp
    ```
  </Step>
</Steps>

## Update credentials

<Steps>
  <Step title="Open Integrations">Go to **Integrations**.</Step>
  <Step title="Find integration">Find the MCP integration.</Step>
  <Step title="Update credentials">Update authentication credentials.</Step>
  <Step title="Test connection">Test the connection.</Step>
</Steps>

## Server requirements

Your MCP server must meet these requirements:

| Requirement   | Details                           |
| ------------- | --------------------------------- |
| Transport     | Streamable HTTP (no SSE or stdio) |
| Protocol      | HTTPS with valid SSL              |
| Accessibility | Reachable from public internet    |
| Response time | Under 30 seconds per call         |

## Check server logs

Look for:

* Connection timeouts
* Authentication failures (401, 403)
* Unhandled exceptions (500)
* Resource exhaustion

## Test it

```bash theme={null}
curl -X POST https://your-mcp-server.com/mcp/tools/list \
  -H "Authorization: Bearer YOUR_TOKEN"
```

The alert clears after the next successful tool call.