29,99 USD aylık
- 50.000
- kelimelik aylık insanlaştırma hakkı ve 50.000 kelimelik yeniden yazma hakkı
- 20.000
- tek çağrıda kelime
- 60
- her 60 saniyede anahtar başına istek
- 4 / 2
- anahtar başına eşzamanlı tespit ve yeniden yazma çağrısı
Model Context Protocol, bir yapay zeka asistanının harici araçları çağırmasını sağlayan açık bir standarttır. MCP sunucumuz aşağıdaki adreste çevrimiçi çalışır. Yalnızca bilgisayarındaki programları başlatabilen istemciler ise küçük sunucu dosyamızı çalıştırır. Her iki yöntem de yalnızca senin anahtarınla bu sitenin API'sini çağırır. Böylece ajanın sitedeki sonuçların aynısını alır.
Ajanın aldığı her sonuç, sayısal değeri, bu değere ilişkin belirsizliği ve kalibrasyon durumunu içerir. Böylece ajan, sonucun ne anlama geldiğini ve hangi durumlarda kullanılmaması gerektiğini açıklayabilir.
İstemcini seç. Her sekmede kurulum adımları, kopyalayacağın yapılandırma ve bağlantıyı test etme yöntemi var. Komutlar ve yapılandırmalar tüm dillerde aynıdır.
Claude Code Çevrimiçi bağlanır
API anahtarını, istemcinin çalıştığı ortamda TEXTLUME_API_KEY adlı bir ortam değişkeninde sakla:
Bunu terminalde çalıştır:
Ya da bunun yerine şunu .mcp.json dosyasına ekle:
{
"mcpServers": {
"textlume": {
"type": "http",
"url": "https://textlume.com/api/mcp",
"headers": {
"Authorization": "Bearer ${TEXTLUME_API_KEY}"
}
}
}
}Çalıştığını kontrol etmek için asistanına şu isteği gönder: "Bu paragrafı Textlume ile kontrol et, aralığı ve güven düzeyini söyle."
API anahtarın, kontrol panelindeki API bölümünde. Anahtarını asla paylaşılan bir dosyaya veya kod deposuna ekleme.
Claude Desktop Sunucu dosyasını çalıştırır
Sunucu dosyasını indir ve kaydettiğin konumu not et. Çalışması için Node.js gerekir.
Sunucu dosyasını indirUygulamada şu yolu izle: Settings > Developer > Edit Config.
Bunu claude_desktop_config.json dosyasına ekle:
{
"mcpServers": {
"textlume": {
"command": "node",
"args": [
"/path/to/server.mjs"
],
"env": {
"TEXTLUME_API_KEY": "YOUR_API_KEY"
}
}
}
}Sunucunun yüklenmesi için Claude Desktop uygulamasını kapatıp yeniden başlat.
Çalıştığını kontrol etmek için asistanına şu isteği gönder: "Bu paragrafı Textlume ile kontrol et, aralığı ve güven düzeyini söyle."
API anahtarın, kontrol panelindeki API bölümünde. Anahtarını asla paylaşılan bir dosyaya veya kod deposuna ekleme.
Claude (claude.ai) Yakında
claude.ai'ı Textlume hesabına giriş yaparak bağlama seçeneği yakında gelecek. O zamana kadar aynı araçları ilgili sekmelerdeki kurulum adımlarıyla Claude Desktop'ta sunucu dosyası üzerinden veya Claude Code'da kullanabilirsin.
Yalnızca kuruluşunda özel bağlayıcılar için istek başlıkları seçeneği varsa adresi bu başlıkla ekle.
ChatGPT Yakında
ChatGPT'yi Textlume hesabına giriş yaparak bağlama seçeneği yakında gelecek. O zamana kadar aynı araçları Codex ve Claude Code sekmelerindeki kurulum adımlarıyla kullanabilirsin.
Codex Çevrimiçi bağlanır
API anahtarını, istemcinin çalıştığı ortamda TEXTLUME_API_KEY adlı bir ortam değişkeninde sakla:
Bunu terminalde çalıştır:
Ya da bunun yerine şunu ~/.codex/config.toml dosyasına ekle:
[mcp_servers.textlume]
url = "https://textlume.com/api/mcp"
bearer_token_env_var = "TEXTLUME_API_KEY"Uygulamada şu yolu izle: MCP servers > Add server > Streamable HTTP.
Çalıştığını kontrol etmek için asistanına şu isteği gönder: "Bu paragrafı Textlume ile kontrol et, aralığı ve güven düzeyini söyle."
API anahtarın, kontrol panelindeki API bölümünde. Anahtarını asla paylaşılan bir dosyaya veya kod deposuna ekleme.
Cursor Çevrimiçi bağlanır
API anahtarını, istemcinin çalıştığı ortamda TEXTLUME_API_KEY adlı bir ortam değişkeninde sakla:
Bunu ~/.cursor/mcp.json dosyasına ekle:
{
"mcpServers": {
"textlume": {
"url": "https://textlume.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:TEXTLUME_API_KEY}"
}
}
}
}Çalıştığını kontrol etmek için asistanına şu isteği gönder: "Bu paragrafı Textlume ile kontrol et, aralığı ve güven düzeyini söyle."
API anahtarın, kontrol panelindeki API bölümünde. Anahtarını asla paylaşılan bir dosyaya veya kod deposuna ekleme.
VS Code (Copilot) Çevrimiçi bağlanır
Bunu .vscode/mcp.json dosyasına ekle:
{
"inputs": [
{
"type": "promptString",
"id": "textlume-key",
"description": "Textlume API key",
"password": true
}
],
"servers": {
"textlume": {
"type": "http",
"url": "https://textlume.com/api/mcp",
"headers": {
"Authorization": "Bearer ${input:textlume-key}"
}
}
}
}Sunucu başladığında VS Code anahtarını bir kez sorar ve kaydeder.
Çalıştığını kontrol etmek için asistanına şu isteği gönder: "Bu paragrafı Textlume ile kontrol et, aralığı ve güven düzeyini söyle."
API anahtarın, kontrol panelindeki API bölümünde. Anahtarını asla paylaşılan bir dosyaya veya kod deposuna ekleme.
Windsurf Çevrimiçi bağlanır
API anahtarını, istemcinin çalıştığı ortamda TEXTLUME_API_KEY adlı bir ortam değişkeninde sakla:
Uygulamada şu yolu izle: Cascade > ... > Open MCP config file.
Bunu mcp_config.json dosyasına ekle:
{
"mcpServers": {
"textlume": {
"serverUrl": "https://textlume.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:TEXTLUME_API_KEY}"
}
}
}
}Sunucunun yüklenmesi için Windsurf uygulamasını kapatıp yeniden başlat.
Çalıştığını kontrol etmek için asistanına şu isteği gönder: "Bu paragrafı Textlume ile kontrol et, aralığı ve güven düzeyini söyle."
API anahtarın, kontrol panelindeki API bölümünde. Anahtarını asla paylaşılan bir dosyaya veya kod deposuna ekleme.
Gemini CLI Çevrimiçi bağlanır
API anahtarını, istemcinin çalıştığı ortamda TEXTLUME_API_KEY adlı bir ortam değişkeninde sakla:
Bunu terminalde çalıştır:
Ya da bunun yerine şunu ~/.gemini/settings.json dosyasına ekle:
{
"mcpServers": {
"textlume": {
"httpUrl": "https://textlume.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Çalıştığını kontrol etmek için asistanına şu isteği gönder: "Bu paragrafı Textlume ile kontrol et, aralığı ve güven düzeyini söyle."
API anahtarın, kontrol panelindeki API bölümünde. Anahtarını asla paylaşılan bir dosyaya veya kod deposuna ekleme.
Other clients Çevrimiçi, köprü veya dosya ile
Uzak MCP sunucularına HTTP üzerinden bağlanan bir istemci için yalnızca şu iki değer gerekir:
Yalnızca yerel sunucuları başlatabilen bir istemci, açık kaynaklı mcp-remote köprüsü üzerinden adrese erişebilir. Bunun için Node.js gerekir:
Ya da sunucu dosyamızı kendin çalıştır:
Sunucu dosyasını indirAPI anahtarın, kontrol panelindeki API bölümünde. Anahtarını asla paylaşılan bir dosyaya veya kod deposuna ekleme.
Bu kurulumu biri için yapan bir yapay zeka asistanıysan sunucu adresi şu: https://textlume.com/api/mcp. Sunucu, Streamable HTTP üzerinden MCP kullanır ve kullanıcının API anahtarını "Authorization: Bearer <key>" biçiminde bekler. Her istemci için tüm kurulum adımları Markdown biçiminde şu adreste: https://textlume.com/mcp.md.
Bu skill ile Claude hangi aracı ne zaman çağıracağını, yapay zeka dedektörü sonucunu nasıl okuyacağını, planının sınırlarını ve bir çağrı başarısız olunca ne yapacağını bilir. ~/.claude/skills altında textlume adlı bir klasöre SKILL.md olarak kaydet (Claude Code) ya da klasörü ZIP yapıp Ayarlar, Yetenekler, Skills bölümünden yükle (Claude uygulamaları). Skill İngilizcedir ve her dilde çalışır.
SKILL.md dosyasını indir---
name: textlume
description: Check text for AI writing, humanize or paraphrase it while keeping its facts, summarize it, and check its grammar with the Textlume MCP tools. Use when the textlume MCP server is connected and the user asks to check whether text reads as AI-written, rewrite AI-sounding text, reword, summarize or proofread.
---
# Textlume writing tools
Textlume gives an agent six tools over MCP: an AI detector, a humanizer, a paraphraser, a summarizer and a grammar checker. Every call goes through the Textlume API with the user's own API key.
## Setup
1. The user needs the Pro plan and an API key from the Textlume dashboard (API section).
2. Put the key in the environment as `TEXTLUME_API_KEY`. Never write the key into a file that gets committed, and never print it.
3. Connect the hosted server. In Claude Code:
```sh
claude mcp add --transport http textlume https://textlume.com/api/mcp --header "Authorization: Bearer $TEXTLUME_API_KEY"
```
In Claude Desktop or another client: server URL `https://textlume.com/api/mcp`, header `Authorization: Bearer <key>`. A client that only runs local servers can start the stdio server from https://textlume.com/mcp/server.mjs with `node server.mjs` and `TEXTLUME_API_KEY` set.
4. Check: list the tools. You should see `detect_text`, `detect_batch`, `humanize_text`, `paraphrase_text`, `summarize_text`, `check_grammar`.
## Which tool to call
### `detect_text` (POST /api/v1/detect)
When: The user asks whether a text reads as AI-written, wants an AI score, or wants to know which sentences read as machine-like.
What it does: Read how likely a text was written by a language model. Returns a figure from 0 to 100 with its margin, our confidence rating (low, medium or high), and a reading for every sentence. Use the figure only when calibrated is true: false means the language has no fitted curve yet.
Arguments:
- `text` (required): The text to check. Too short a text gets no reading (the error says the minimum)
- `language`: Two-letter code. Omitted, the service reads it from the text
- `contentType`: essay, article, email, code
### `detect_batch` (POST /api/v1/detect/batch)
When: The user hands over several texts at once (a folder of essays, a list of posts). One call, one result per item.
What it does: Check many texts in one call. Each item carries its own id and either a reading or an error; one item failing never fails the batch.
Arguments:
- `items` (required)
### `humanize_text` (POST /api/v1/humanize)
When: The user wants AI-sounding text to read more like a person wrote it. Show the before and after reading the tool returns.
What it does: Rewrite machine-sounding text so it reads more like a person wrote it, scored by our own detector before and after. It keeps every fact: a rewrite that changes one is refused and the original sentence is put back. It does not promise to defeat any other detector.
Arguments:
- `text` (required)
- `mode`: natural, formal, simple, academic, creative, shorten or expand
- `tab`: standard, academic, professional, casual
- `strength`: regular, aggressive
- `language`
### `paraphrase_text` (POST /api/v1/paraphrase)
When: The user wants the same meaning in different words (rewording, simplifying, shortening, a different register).
What it does: Reword a text while keeping its meaning. Same guarantees as humanize_text, with the paraphraser modes.
Arguments:
- `text` (required)
- `mode`: standard, fluency, formal, academic, simple, creative, expand or shorten
- `strength`: readable, balanced, strong
- `language`
### `summarize_text` (POST /api/v1/summarize)
When: The user wants the main points of a long text, as key sentences, a paragraph or bullets.
What it does: Summarise a text as key sentences, a paragraph or bullet points.
Arguments:
- `text` (required)
- `mode`: key-sentences, paragraph, bullets
- `length`: short, medium, long
### `check_grammar` (POST /api/v1/grammar)
When: The user wants spelling, grammar and punctuation checked. Apply only the fixes the user accepts.
What it does: Find grammar, spelling and punctuation problems, each with its position, an explanation and replacements.
Arguments:
- `text` (required)
- `language`: For example en-US or de-DE
## Reading a detector result
- Every result has a figure from 0 to 100, a margin, a confidence rating (low, medium, high) and a reading per sentence. Report the figure with its margin and the rating, never a bare percentage.
- If `calibrated` is false, the language has no fitted line yet. Say there is no reading for that language and do not quote the figure as a result.
- The figure says how machine-like the text reads, not what share a machine wrote, and it is not proof of who wrote it. Never call a text "detected". Point to the sentences that read as machine-like instead.
- Texts under 50 words get no reading. Short texts always get a low confidence rating.
## Rewrites
- `humanize_text` and `paraphrase_text` keep names, numbers, quotations and claims. A sentence whose rewrite would change a fact is put back as it was, and the result notes say so. Pass those notes on to the user.
- The before and after figures are Textlume's own detector. Do not promise the user that any other detector will agree.
- Hand the user the rewritten text in full. Do not rewrite it again yourself before showing it.
## Limits
- 60 requests per 60 seconds per key.
- At most 4 detector calls and 2 rewrite or summary calls at the same time per key.
- Up to 20,000 words per call. The detector reads up to 10,000 words (90,000 characters) per text. Split longer texts and say that you did.
- `detect_batch` takes up to 50 items.
- Words count against the monthly words of the user's plan.
## Errors
The tool result carries the API's own message. Act on the code:
- `no_key` or `bad_key` (401): the key is missing or wrong. Ask the user to set `TEXTLUME_API_KEY`. Do not retry.
- `out_of_scope` (403): the key was created without this tool's scope. The user creates a key with that scope on the dashboard.
- `plan_lapsed` (403): the Pro plan is not active. Tell the user, do not retry.
- words used up (402): the response has `available`, the words left this month. Offer to send a shorter text.
- `rate_limited` or `concurrency_limited` (429): wait the seconds in `retry-after`, then retry once. Send batches one after another, not in parallel.
- `text_too_long` (413): split the text and check the parts, and say so.
- `too_short` (422): the text is under 50 words. `not_calibrated` (422): no reading for that language.
- `engine_starting`, `engine_busy`, `engine_unavailable` (503) or `engine_timeout` (504): the service is not available right now. Wait and retry once. Never make up a result.
Bir isteği kopyalayıp ajanına gönder ve metnini ekle. Ajan, kullanacağı aracı kendi seçer.
detect_textTek bir metni analiz eder.
İstek
Dönen sonuç
0 ile 100 arasında bir değer, hata payı, güven düzeyi ve her cümle için ayrı bir sonuç.
detect_batchBirden fazla metni analiz eder.
İstek
Dönen sonuç
Her metin için kendi kimliği altında bir sonuç veya hata. Bir metinde hata olması diğerlerini etkilemez.
humanize_textMetni insanlaştırır ve bilgi doğrulama sonuçlarını sunar.
İstek
Dönen sonuç
Yeniden yazılmış metin, aracımızın işlem öncesi ve sonrası yapay zeka tespit sonuçları ve olgusal bilgiyi korumak için eski haline döndürülen her cümleye ilişkin bir not.
paraphrase_textMetni yeniden yazar.
İstek
Dönen sonuç
Metni insanlaştırma aracındakiyle aynı olgu kontrollerinden geçen, yeniden yazılmış metin.
summarize_textMetni özetler.
İstek
Dönen sonuç
Önemli cümleler, paragraf veya madde listesi biçiminde özet.
check_grammarYazım ve dil bilgisini kontrol eder.
İstek
Dönen sonuç
Her sorunun metindeki yeri, açıklaması ve önerilen düzeltmeler.
MCP sunucusu API anahtarını kullanır. Bu nedenle her çağrı, API ile aynı plana, kullanım hakkına ve sınırlara tabidir.
29,99 USD aylık
Her çağrı, sitedekiyle aynı miktarda kelime kullanır. İnsanlaştırma çağrısı Pro planının insanlaştırma hakkından, özetleme çağrısı ise özetleme hakkından düşülür. Bu haklar bittiğinde insanlaştırma ve yeniden yazma çağrıları ek kelime paketlerini kullanır. Yeterli kelime hakkın yoksa çağrı reddedilir ve hiçbir kullanım düşülmez. Her yanıt, kaç kelime kullanıldığını ve kaç kelime kaldığını gösterir.
Pro planına API erişimi dahildir. API çağrıları, sitedeki işlemlerle aynı kelime haklarını kullanır. Tespit çağrısı yapay zeka tespit aracı için ayrılan kelimelerden, insanlaştırma çağrısı metni insanlaştırma aracı için ayrılan kelimelerden, özetleme çağrısı da metin özetleme aracı için ayrılan kelimelerden düşülür. Önce tüketilecek ayrı bir API kotası yoktur. İlgili kelime hakkı bittiğinde yapay zeka tespit aracı, metni insanlaştırma aracı veya metin yeniden yazma aracı çağrıları, sitede olduğu gibi hesabın ek kelime bakiyesini kullanır. Diğer araçlar ek kelime bakiyesini kullanamaz. Kalan kelime hakkı ve ek bakiye birlikte çağrıyı karşılamaya yetmiyorsa çağrı 402 koduyla reddedilir ve kelime hakkından düşülmez. Başarılı her yanıt, recorded değeri false olmadığı sürece, kaç kelime kullanıldığını, hangi haktan düşüldüğünü ve ne kadar kaldığını bildirir. Ele geçirilen bir anahtarın tüm bakiyeyi tek seferde tüketmesini önlemek için hesabın API kullanımı, bakiyeden bağımsız olarak, bir fatura döneminde 250.000 kelimeyle sınırlıdır.
Giriş yap, ardından kontrol panelinden bir anahtar oluştur.
Kontrol panelinden anahtar oluşturAPI neler yaparAPI belgeleri