# MCP for developers: Connect Claude to the Islamic library (MCP)

Source: https://qurangallery.com/docs/mcp/claude

> Add the Quran Gallery MCP server to Claude (claude.ai and Desktop) as a custom connector, with screenshots. No account or key, 8,594 Arabic works.

**No account, no sign-in, no key.** In Claude, add one custom connector with this URL:

```
https://qurangallery.com/mcp/shamela
```

The steps are the same on claude.ai and in Claude Desktop. Free plans can add one custom connector. On Team and Enterprise plans, an Owner adds it under **Organization settings → Connectors** and each member then switches it on.

## 1. Open Connectors and add a custom connector

Open **Settings → Connectors** ([claude.ai/settings/connectors](https://claude.ai/settings/connectors)). Some versions put it under **Customize → Connectors**. Click **+ Add**, then **Add custom connector**.

## 2. Name it and paste the URL

Name it `Quran Gallery`, paste `https://qurangallery.com/mcp/shamela`, and click **Continue**.

## 3. Keep No sign-in, then add and connect

Claude checks the server and selects **No sign-in**, marked _Detected_. Leave it selected. You can ignore the **Request headers** section unless you have a key (see the end of this page). Click **Add**, then **Connect**. A message confirms _Connected to Quran Gallery_.

## 4. Choose when Claude may use the tools

The connector page lists 15 read-only tools, set to **Needs approval** by default. Leave that to approve each call, or set **Read-only tools** to **Always allow** to skip the prompts.

## 5. Switch it on in a chat

In a chat, click **+**, open **Connectors**, and switch **Quran Gallery** on.

## 6. Ask, and approve the first call

When Claude first uses a tool, it asks. Click **Allow once**, or **Always allow** for that tool.

The answer names each printed edition with its volume and page:

## First prompt to try

> _Find the hadith «إنما الأعمال بالنيات» in the primary collections and tell me which book, edition, volume and page it is printed on. Quote the Arabic exactly._

Your assistant should call `shamela_search_library` (or `search` then `fetch`). The hits include **صحيح البخاري, ط السلطانية, page 1/6**, with a link to that page in the Maktabah reader. If it answers from memory instead, say: _"Use the Quran Gallery library tool and quote what it returns."_

Search queries must be in Arabic; your assistant translates English terms first ([details](https://qurangallery.com/docs/mcp/search-library)). Ready-made prompts for takhrīj, citing a passage and comparing tafsir are listed in [the full tool surface](https://qurangallery.com/docs/mcp/tools).

## Troubleshooting

- **429, "Keyless limit reached".** Keyless use allows 10 tool calls a minute and 200 a day per IP address. Wait for the `Retry-After` header, or add a free key (below). See [Limits and errors](https://qurangallery.com/docs/mcp/limits-and-errors).
- **503.** The server or the library behind it is briefly unavailable. Retry after the `Retry-After` header. If the connector lists zero tools, wait a minute and refresh the tool list.
- **The tools do not appear, or a tool you expect is missing.** On the connector page, open the **⋮** menu and choose **Refresh tools list**, then start a new chat.
- **Claude answers without the library.** Check that the connector is switched on for this chat (step 5), and ask it to use the Quran Gallery tools.
- **Connection fails immediately.** The endpoint is `/mcp/shamela`. The bare `/mcp` is a web page, not the server.

## Optional: a free key for higher limits

A key is never required. A free key raises the limit to 60 calls a minute and lifts the keyless page-range caps. Create one on the **Developers** page of your Quran Gallery account ([how keys work](https://qurangallery.com/docs/accounts/api-keys)).

Add the key at step 3. Keep **No sign-in** selected, and under **Request headers** add a header named `Authorization` with the value `Bearer qg_sk_your_key_here`. Use your own key in place of the placeholder. If the connector already exists, remove it from the **⋮** menu and add it again with the header.

## Next steps

- [Open Quran Gallery MCP](https://qurangallery.com/mcp)
- [Connect ChatGPT to the Shamela library](https://qurangallery.com/docs/mcp/chatgpt)
- [Add the Islamic library MCP server to Claude Code](https://qurangallery.com/docs/mcp/claude-code)
- [MCP server for Islamic texts: what it does](https://qurangallery.com/docs/mcp/overview)
