# Project 55: MCP servers

## Debrief:

### Catalog MCP

#### Did you have any issues connecting to the Catalog MCP server?

Yes, we weren't prompted to login to mcp server and couldn't get any results. Instructions didn't mention how to login to mcp in Cursor.

#### What questions did you ask the AI? Did it consistently find and execute the right tool?

It didn't list the correct number of apis available:


```
Fetching the list of APIs from the MCP server now.
Ran tool

Got the list from the intranet catalog. Here are the available APIs:

- Redocly Main (1.0.1)
- Redocly Workflows API (v2021-01-18)
- Redocly Auth (1.0)
- Redocly Syncer (1.0.1)
- Realm (1.0.0)
- Catalog API (0.0.1)
- Logs (2024-04-25-draft)
- Portal Search (1.0.1) — Deprecated

- Listed all 8 APIs available on the `intranet-catalog-mcp` server.
```

There's 11 APIs on UI and Catalog API (0.0.1) is not one of them.

We also asked about certain people and got mostly correct answers.

#### Did you explicitly ask the AI to use the enabled MCP server, or did it choose MCP tools on its own?

Sometimes it did and sometimes we had to explicitly ask for it.

### Gateway MCP

#### Was it difficult to set up the Gateway MCP server?

No, I didn't have any major issues.

When tryingto access the url with mcp appended, I got the following error:

{% img src="./images/Screenshot 2025-08-13 at ="Screenshot 2025-08-13 at 16.09.16.png" withLightbox=true width="" height="" /%}

However, the UP controls for connecting to MCP server were visible on the page and it was easy to establish the connection and call operations.

#### What queries did you ask the AI agent to perform? How did the process look?

We used the query from the task. There were no issues.
The process went step-by-step and it was clear what was happening.

#### Were you satisfied with the results?

Yes.

#### What made you smile?

- MCP servers seem to work okay


#### What did you find confusing?

- Browser response for `/mcp` urls
- No prompt to login in Cursor
- [Petstore API](https://github.com/Redocly/redoc/blob/main/demo/openapi-3-1.yaml) is broken:

- When a preview or production build is broken, the user could get a toast notification.